gdc-sdk-front-ts 2.1.2 → 2.3.0

package/dist/gdc-common-utils-ts/src/utils/communication-bundle-session.js

@@ -1,326 +0,0 @@
-// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
-// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
-import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types';
-import { ClaimConsent } from '../models/consent-rule';
-import { CommunicationClaim } from '../models/interoperable-claims/communication-claims';
-import { BundleQuery } from './bundle-query';
-import { MedicationStatementClaim, } from '../models/interoperable-claims/medication-statement-claims';
-/**
- * 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 class CommunicationBundleSession {
-    constructor(options = {}) {
-        this.mode = options.mode || 'strict';
-        this.communicationClaims = {
-            ...options.communicationClaims,
-        };
-        this.activeEntryIndex = null;
-        const providedBundle = options.initialBundle ? cloneBundle(options.initialBundle) : undefined;
-        this.bundleInMemory = providedBundle || this.decodeBundleFromClaims(this.communicationClaims);
-        this.syncAttachmentFromBundle();
-    }
-    /** Returns a deep copy of communication claims. */
-    getCommunicationClaims() {
-        return {
-            ...this.communicationClaims,
-        };
-    }
-    /** Returns a deep copy of the current in-memory bundle. */
-    getBundleInMemory() {
-        return cloneBundle(this.bundleInMemory);
-    }
-    /** Returns the active entry index, or null when no entry is selected. */
-    getActiveEntryIndex() {
-        return this.activeEntryIndex;
-    }
-    /** Returns a deep copy of the active entry when selected. */
-    getActiveEntry() {
-        if (this.activeEntryIndex === null) {
-            return null;
-        }
-        return cloneEntry(this.bundleInMemory.data[this.activeEntryIndex]);
-    }
-    /** Selects an active entry by index or fullUrl. */
-    selectActiveEntry(selection) {
-        if (typeof selection.index === 'number') {
-            this.assertEntryIndex(selection.index);
-            this.activeEntryIndex = selection.index;
-            return this;
-        }
-        if (selection.fullUrl) {
-            const foundIndex = this.bundleInMemory.data.findIndex((entry) => String(entry?.fullUrl || '').trim() === selection.fullUrl);
-            if (foundIndex < 0) {
-                throw new Error(`Active entry not found for fullUrl: ${selection.fullUrl}`);
-            }
-            this.activeEntryIndex = foundIndex;
-            return this;
-        }
-        throw new Error('selectActiveEntry requires either index or fullUrl.');
-    }
-    /** Clears active entry selection from memory. */
-    clearActiveEntry() {
-        this.activeEntryIndex = null;
-        return this;
-    }
-    /**
-     * Upserts an entry in bundle memory and marks it as active.
-     * Matching priority: `fullUrl` if present, then resource claim identifier.
-     */
-    upsertActiveEntry(input) {
-        const entry = this.createBundleEntry(input);
-        const nextIndex = this.findUpsertIndex(entry, input.fullUrl);
-        if (nextIndex >= 0) {
-            this.bundleInMemory.data[nextIndex] = entry;
-            this.activeEntryIndex = nextIndex;
-        }
-        else {
-            this.bundleInMemory.data.push(entry);
-            this.activeEntryIndex = this.bundleInMemory.data.length - 1;
-        }
-        this.syncAttachmentFromBundle();
-        return this;
-    }
-    /**
-     * Consent-first helper for developer onboarding.
-     *
-     * Expected keys should come from `ClaimConsent` in caller code.
-     */
-    upsertActiveConsentEntry(input) {
-        return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.Consent,
-            claims: input.claims,
-            fullUrl: input.fullUrl,
-            type: input.type,
-            request: input.request,
-        });
-    }
-    /**
-     * MedicationStatement helper for IPS-in-Communication use cases.
-     *
-     * Expected keys should come from MedicationStatement claims constants.
-     */
-    upsertActiveMedicationStatementEntry(input) {
-        return this.upsertActiveEntry({
-            resourceType: ResourceTypesFhirR4.MedicationStatement,
-            claims: {
-                ...input.claims,
-            },
-            fullUrl: input.fullUrl,
-            type: input.type,
-            request: input.request,
-        });
-    }
-    /**
-     * Patches active entry `resource.meta.claims` and synchronizes attachment data.
-     */
-    patchActiveEntryClaims(claimPatch) {
-        if (this.activeEntryIndex === null) {
-            throw new Error('No active entry selected.');
-        }
-        const current = cloneEntry(this.bundleInMemory.data[this.activeEntryIndex]);
-        const resource = ensureEntryResource(current, this.mode);
-        resource.meta = resource.meta || {};
-        resource.meta.claims = {
-            ...(resource.meta.claims || {}),
-            ...claimPatch,
-        };
-        current.resource = resource;
-        this.bundleInMemory.data[this.activeEntryIndex] = current;
-        this.syncAttachmentFromBundle();
-        return this;
-    }
-    /**
-     * Persists current memory state into communication claims attachment.
-     * No-op for active entry pointer.
-     */
-    saveActiveEntry() {
-        this.syncAttachmentFromBundle();
-        return this;
-    }
-    /**
-     * Persists and releases active entry memory pointer.
-     * This is the recommended step after a successful save operation.
-     */
-    saveAndReleaseActiveEntry() {
-        this.syncAttachmentFromBundle();
-        this.clearActiveEntry();
-        return this;
-    }
-    /**
-     * Returns stable resource IDs from bundle entries with optional filters.
-     */
-    getResourceIds(filters = {}) {
-        const query = new BundleQuery(this.bundleInMemory);
-        return query.getResourceIds(filters);
-    }
-    /**
-     * Returns bundle entries matching resource IDs produced by `getResourceIds`.
-     */
-    getResourceEntriesByIds(resourceIds) {
-        const query = new BundleQuery(this.bundleInMemory);
-        return query.getResourceEntriesByIds(resourceIds);
-    }
-    /**
-     * Resolves the entry URL (`fullUrl`) for a given entry/resource identifier.
-     */
-    getEntryUrl(entryId) {
-        const query = new BundleQuery(this.bundleInMemory);
-        return query.getEntryUrl(entryId);
-    }
-    decodeBundleFromClaims(claims) {
-        const encoded = asTrimmedString(claims[CommunicationClaim.ContentAttachmentData]);
-        if (!encoded) {
-            return createEmptyBundle();
-        }
-        try {
-            const text = Buffer.from(encoded, 'base64').toString('utf8');
-            const parsed = JSON.parse(text);
-            validateBundleLike(parsed, this.mode);
-            return cloneBundle(parsed);
-        }
-        catch (error) {
-            if (this.mode === 'normalize') {
-                return createEmptyBundle();
-            }
-            throw new Error(`Invalid ${CommunicationClaim.ContentAttachmentData}: ${error.message}`);
-        }
-    }
-    syncAttachmentFromBundle() {
-        this.communicationClaims[CommunicationClaim.ContentAttachmentType] = 'application/fhir+json';
-        this.communicationClaims[CommunicationClaim.ContentAttachmentData] = encodeBundleToBase64(this.bundleInMemory);
-        const activeSubject = this.resolveCurrentSubject();
-        if (activeSubject) {
-            this.communicationClaims[CommunicationClaim.Subject] = activeSubject;
-        }
-    }
-    resolveCurrentSubject() {
-        if (this.activeEntryIndex !== null) {
-            const claims = this.bundleInMemory.data[this.activeEntryIndex]?.resource?.meta?.claims || {};
-            const consentSubject = asTrimmedString(claims[ClaimConsent.subject]);
-            if (consentSubject) {
-                return consentSubject;
-            }
-            const medicationSubject = asTrimmedString(claims[MedicationStatementClaim.Subject]);
-            if (medicationSubject) {
-                return medicationSubject;
-            }
-        }
-        const fromClaims = asTrimmedString(this.communicationClaims[CommunicationClaim.Subject]);
-        return fromClaims || undefined;
-    }
-    findUpsertIndex(entry, fullUrl) {
-        if (fullUrl) {
-            const byFullUrl = this.bundleInMemory.data.findIndex((item) => String(item?.fullUrl || '').trim() === fullUrl);
-            if (byFullUrl >= 0) {
-                return byFullUrl;
-            }
-        }
-        const incomingClaims = entry.resource?.meta?.claims || {};
-        const incomingIdentifier = this.resolveEntryIdentifier(incomingClaims);
-        if (!incomingIdentifier) {
-            return -1;
-        }
-        return this.bundleInMemory.data.findIndex((item) => {
-            const itemClaims = item?.resource?.meta?.claims || {};
-            return this.resolveEntryIdentifier(itemClaims) === incomingIdentifier;
-        });
-    }
-    resolveEntryIdentifier(claims) {
-        const consentIdentifier = asTrimmedString(claims[ClaimConsent.identifier]);
-        if (consentIdentifier) {
-            return `${ResourceTypesFhirR4.Consent}:${consentIdentifier}`;
-        }
-        const medicationIdentifier = asTrimmedString(claims[MedicationStatementClaim.Identifier]);
-        if (medicationIdentifier) {
-            return `${ResourceTypesFhirR4.MedicationStatement}:${medicationIdentifier}`;
-        }
-        return '';
-    }
-    createBundleEntry(input) {
-        const resourceClaims = {
-            ...input.claims,
-        };
-        const canonicalEntryIdentifier = this.resolveEntryCanonicalIdValue(resourceClaims);
-        return {
-            id: canonicalEntryIdentifier || undefined,
-            type: input.type || `${input.resourceType}-edit-request-v1.0`,
-            fullUrl: input.fullUrl,
-            request: input.request,
-            resource: {
-                resourceType: input.resourceType,
-                meta: {
-                    claims: resourceClaims,
-                },
-            },
-        };
-    }
-    resolveEntryCanonicalIdValue(claims) {
-        const consentIdentifier = asTrimmedString(claims[ClaimConsent.identifier]);
-        if (consentIdentifier) {
-            return consentIdentifier;
-        }
-        const medicationIdentifier = asTrimmedString(claims[MedicationStatementClaim.Identifier]);
-        if (medicationIdentifier) {
-            return medicationIdentifier;
-        }
-        const communicationIdentifier = asTrimmedString(claims[CommunicationClaim.Identifier]);
-        if (communicationIdentifier) {
-            return communicationIdentifier;
-        }
-        return '';
-    }
-    assertEntryIndex(index) {
-        if (!Number.isInteger(index) || index < 0 || index >= this.bundleInMemory.data.length) {
-            throw new Error(`Entry index out of range: ${index}`);
-        }
-    }
-}
-function ensureEntryResource(entry, mode) {
-    const resource = entry.resource;
-    if (resource && typeof resource === 'object') {
-        return resource;
-    }
-    if (mode === 'normalize') {
-        return { meta: { claims: {} } };
-    }
-    throw new Error('Active entry does not contain a valid resource object.');
-}
-function validateBundleLike(bundle, mode) {
-    const looksLikeBundle = bundle && bundle.resourceType === ResourceTypesFhirR4.Bundle && Array.isArray(bundle.data);
-    if (looksLikeBundle) {
-        return;
-    }
-    if (mode === 'normalize') {
-        return;
-    }
-    throw new Error('Decoded attachment is not a valid BundleJsonApi payload.');
-}
-function createEmptyBundle() {
-    return {
-        resourceType: ResourceTypesFhirR4.Bundle,
-        type: 'batch',
-        data: [],
-    };
-}
-function encodeBundleToBase64(bundle) {
-    return Buffer.from(JSON.stringify(bundle), 'utf8').toString('base64');
-}
-function cloneBundle(bundle) {
-    return JSON.parse(JSON.stringify(bundle));
-}
-function cloneEntry(entry) {
-    return JSON.parse(JSON.stringify(entry));
-}
-function asTrimmedString(value) {
-    if (value === undefined || value === null) {
-        return '';
-    }
-    return String(value).trim();
-}

package/dist/gdc-common-utils-ts/src/utils/communication-document-reference.d.ts

@@ -1,41 +0,0 @@
-import { EvidenceObjectDLT } from '../models/oidc4ida.evidence.model';
-export type AttachmentKind = 'fhir' | 'pdf' | 'png' | 'jpg' | 'binary';
-export type BuildMode = 'strict' | 'normalize';
-export type BuildDocumentReferenceOptions = {
-    /**
-     * strict: validation errors throw.
-     * normalize: best-effort defaults + warnings.
-     */
-    mode?: BuildMode;
-};
-export type BuildDocumentReferenceResult = {
-    /**
-     * Generated or normalized DocumentReference projection.
-     *
-     * Current simplified profile:
-     * - one Communication payload attachment -> one DocumentReference
-     * - one DocumentReference content[0].attachment
-     */
-    documentReference: Record<string, any>;
-    /**
-     * CID for the attached artifact content.
-     * Used as version-like content fingerprint in this profile.
-     */
-    contentCid: string;
-    evidence: EvidenceObjectDLT[];
-    warnings: string[];
-};
-/**
- * Detects the logical attachment kind from a MIME type.
- *
- * @param contentType Attachment content type.
- */
-export declare function detectAttachmentKind(contentType?: string): AttachmentKind;
-/**
- * Builds a simplified `DocumentReference` projection from the first
- * `Communication.payload[0].contentAttachment`.
- *
- * @param communication FHIR `Communication`-like resource carrying the attachment.
- * @param options.mode `strict` throws on invalid input, `normalize` applies best-effort defaults.
- */
-export declare function buildDocumentReferenceFromCommunicationPayload(communication: Record<string, any>, options?: BuildDocumentReferenceOptions): BuildDocumentReferenceResult;

package/dist/gdc-common-utils-ts/src/utils/communication-document-reference.js

@@ -1,170 +0,0 @@
-// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
-import { sha256 } from '@noble/hashes/sha2.js';
-import { utf8ToBytes } from '@noble/hashes/utils.js';
-import { CommunicationClaim } from '../models/interoperable-claims/communication-claims';
-import { DocumentReferenceClaim } from '../models/interoperable-claims/document-reference-claims';
-import { encodeMultibase58btc } from './multibase58.js';
-import { canonicalizeFhirResource, fhirResourceToCid } from './fhir-cid.js';
-const CID_V1 = 0x01;
-const MULTICODEC_RAW = 0x55;
-const MULTIHASH_SHA2_256_CODE = 0x12;
-const MULTIHASH_SHA2_256_LEN = 32;
-function encodeVarint(value) {
-    const out = [];
-    let n = value >>> 0;
-    while (n >= 0x80) {
-        out.push((n & 0x7f) | 0x80);
-        n >>>= 7;
-    }
-    out.push(n);
-    return Uint8Array.from(out);
-}
-function concatBytes(...parts) {
-    const total = parts.reduce((acc, part) => acc + part.length, 0);
-    const out = new Uint8Array(total);
-    let offset = 0;
-    for (const part of parts) {
-        out.set(part, offset);
-        offset += part.length;
-    }
-    return out;
-}
-function cidFromBytes(bytes) {
-    const digest = sha256(bytes);
-    const multihash = concatBytes(Uint8Array.from([MULTIHASH_SHA2_256_CODE, MULTIHASH_SHA2_256_LEN]), digest);
-    const cidBytes = concatBytes(encodeVarint(CID_V1), encodeVarint(MULTICODEC_RAW), multihash);
-    return encodeMultibase58btc(cidBytes);
-}
-function decodeBase64(data) {
-    return Uint8Array.from(Buffer.from(data, 'base64'));
-}
-function toStringOrUndefined(value) {
-    if (value === undefined || value === null)
-        return undefined;
-    const text = String(value).trim();
-    return text || undefined;
-}
-/**
- * Detects the logical attachment kind from a MIME type.
- *
- * @param contentType Attachment content type.
- */
-export function detectAttachmentKind(contentType) {
-    const ct = String(contentType || '').toLowerCase();
-    if (ct.includes('fhir') || ct.includes('application/json+fhir'))
-        return 'fhir';
-    if (ct === 'application/pdf')
-        return 'pdf';
-    if (ct === 'image/png')
-        return 'png';
-    if (ct === 'image/jpg' || ct === 'image/jpeg')
-        return 'jpg';
-    return 'binary';
-}
-function buildEvidenceForKind(kind, cid) {
-    if (kind === 'pdf') {
-        return {
-            type: 'electronic_signature',
-            signature_type: 'detached',
-            issuer: 'did:web:unknown',
-            serial_number: cid,
-            created_at: new Date().toISOString(),
-            attachments: [{ content_type: 'cid', content: cid }],
-        };
-    }
-    return {
-        type: 'electronic_record',
-        record: { type: kind.toUpperCase(), source: 'Communication.payload.contentAttachment', digest: { alg: 'sha-256', value: cid } },
-        check_details: [],
-    };
-}
-function isCidLike(value) {
-    return !!value && value.startsWith('z') && value.length > 10;
-}
-/**
- * Builds a simplified `DocumentReference` projection from the first
- * `Communication.payload[0].contentAttachment`.
- *
- * @param communication FHIR `Communication`-like resource carrying the attachment.
- * @param options.mode `strict` throws on invalid input, `normalize` applies best-effort defaults.
- */
-export function buildDocumentReferenceFromCommunicationPayload(communication, options = {}) {
-    /**
-     * Data model notes:
-     * - FHIR DocumentReference logical identifier and version are distinct concerns.
-     * - Current implementation uses content CID for claims identifier/version-like tracking.
-     * - Future target profile should keep stable DocumentReference.identifier (UUID/URN) and
-     *   store evolving content CID in meta.versionId/content hash fields across versions.
-     * - Multi-attachment DocumentReference content[i] is intentionally out of scope for now;
-     *   roadmap can introduce indexed flat claims such as DocumentReference.attachment[i]-*.
-     */
-    const mode = options.mode ?? 'strict';
-    const warnings = [];
-    const payload = communication?.payload?.[0];
-    const attachment = payload?.contentAttachment;
-    if (!attachment) {
-        throw new Error('Communication payload with contentAttachment is required.');
-    }
-    const contentType = toStringOrUndefined(attachment.contentType) || 'application/octet-stream';
-    if (!attachment.contentType && mode === 'normalize') {
-        warnings.push('Missing contentAttachment.contentType. Defaulting to application/octet-stream.');
-    }
-    const dataBase64 = toStringOrUndefined(attachment.data);
-    const url = toStringOrUndefined(attachment.url);
-    if (!dataBase64 && !url && mode === 'strict') {
-        throw new Error('contentAttachment requires data or url.');
-    }
-    const kind = detectAttachmentKind(contentType);
-    let contentCid = toStringOrUndefined(attachment.id);
-    if (!isCidLike(contentCid)) {
-        if (kind === 'fhir' && dataBase64) {
-            const json = Buffer.from(dataBase64, 'base64').toString('utf8');
-            const parsed = JSON.parse(json);
-            const canonical = canonicalizeFhirResource(parsed);
-            contentCid = fhirResourceToCid(JSON.parse(canonical)).cid;
-        }
-        else if (dataBase64) {
-            contentCid = cidFromBytes(decodeBase64(dataBase64));
-        }
-        else {
-            contentCid = cidFromBytes(utf8ToBytes(url || 'empty-content'));
-        }
-    }
-    if (!contentCid) {
-        throw new Error('Unable to generate content CID from attachment.');
-    }
-    // Good practice note:
-    // reusable Communication claim keys consumed here must come from
-    // `CommunicationClaim`, not re-hardcoded inline in readers/tests.
-    const subject = communication?.meta?.claims?.[CommunicationClaim.Subject];
-    const documentReference = {
-        resourceType: 'DocumentReference',
-        status: 'current',
-        meta: {
-            versionId: contentCid,
-            claims: {
-                [DocumentReferenceClaim.Subject]: subject,
-                [DocumentReferenceClaim.ContentType]: contentType,
-                [DocumentReferenceClaim.Identifier]: contentCid,
-            },
-        },
-        subject: subject ? { reference: subject } : undefined,
-        content: [
-            {
-                attachment: {
-                    id: contentCid,
-                    contentType,
-                    data: dataBase64,
-                    url,
-                    title: toStringOrUndefined(attachment.title),
-                },
-            },
-        ],
-    };
-    return {
-        documentReference,
-        contentCid,
-        evidence: [buildEvidenceForKind(kind, contentCid)],
-        warnings,
-    };
-}

package/dist/gdc-common-utils-ts/src/utils/communication-fhir-r4.d.ts

@@ -1,41 +0,0 @@
-export type CommunicationClaims = Record<string, unknown>;
-export type CommunicationTransformMode = 'strict' | 'normalize';
-export type TransformCommunicationClaimsToResourceFhirR4Options = {
-    mode?: CommunicationTransformMode;
-    defaultStatus?: string;
-};
-export type TransformCommunicationClaimsToResourceFhirR4Result = {
-    resources: Array<Record<string, unknown>>;
-    warnings: string[];
-};
-/**
- * Validates a FHIR R4 `Communication` resource through the configured validator pipeline.
- *
- * @param resource Candidate FHIR R4 `Communication` resource.
- */
-export declare function validateCommunicationResourceFhirR4(resource: Record<string, unknown>): Promise<{
-    ok: boolean;
-    issues: Array<{
-        severity: 'error' | 'warning';
-        code: string;
-        diagnostics: string;
-        expression?: string;
-    }>;
-}>;
-/**
- * Transforms canonical communication claims into FHIR R4 `Communication` resources.
- *
- * @param communicationClaims Flat canonical claims rows to convert.
- * @param options.mode `strict` throws on ambiguous/invalid shapes, `normalize` keeps best-effort output.
- * @param options.defaultStatus Default FHIR status when none is provided.
- */
-export declare function transformCommunicationClaimsToResourceFhirR4(communicationClaims: CommunicationClaims[], options?: TransformCommunicationClaimsToResourceFhirR4Options): TransformCommunicationClaimsToResourceFhirR4Result;
-/**
- * Extracts canonical communication claims from a FHIR R4 `Communication` resource.
- *
- * @param resource FHIR R4 `Communication` resource.
- * @param options.preferMetaClaims When true, existing `resource.meta.claims` wins over structural extraction.
- */
-export declare function extractCommunicationClaimsFromResourceFhirR4(resource: Record<string, unknown>, options?: {
-    preferMetaClaims?: boolean;
-}): CommunicationClaims;