gdc-sdk-front-ts 0.6.2 → 0.6.6

package/dist/gdc-common-utils-ts/src/constants/service-capabilities.js

@@ -0,0 +1,105 @@
+// Copyright 2026 Antifraud Services Inc. 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.
+/**
+ * Canonical capability families persisted through
+ * `org.schema.Service.serviceType`.
+ */
+export const ServiceCapabilityFamily = {
+    Indexing: 'indexing',
+    DigitalTwin: 'digitaltwin',
+};
+/**
+ * Canonical capability tokens currently documented for tenant activation.
+ *
+ * The family prefix is the stable part of the contract. Suffixes such as
+ * `.rs` and `.cruds` can evolve independently across runtimes.
+ */
+export const ServiceCapabilityToken = {
+    IndexReader: 'indexing.rs',
+    IndexProvider: 'indexing.cruds',
+    DigitalTwinReader: 'digitaltwin.rs',
+    DigitalTwinProvider: 'digitaltwin.cruds',
+    /**
+     * @deprecated Prefer `IndexReader`.
+     */
+    IndexingReadSearch: 'indexing.rs',
+    /**
+     * @deprecated Prefer `IndexProvider`.
+     */
+    IndexingCruds: 'indexing.cruds',
+    /**
+     * @deprecated Prefer `DigitalTwinReader`.
+     */
+    DigitalTwinReadSearch: 'digitaltwin.rs',
+    /**
+     * @deprecated Prefer `DigitalTwinProvider`.
+     */
+    DigitalTwinCruds: 'digitaltwin.cruds',
+};
+/**
+ * SDK-facing capability names.
+ *
+ * These names are intentionally more explicit than the persisted claim tokens:
+ * - `Provider` maps to write/manage capability (`*.cruds`)
+ * - `Reader` maps to read/search capability (`*.rs`)
+ */
+export const ServiceCapability = {
+    IndexProvider: ServiceCapabilityToken.IndexProvider,
+    IndexReader: ServiceCapabilityToken.IndexReader,
+    DigitalTwinProvider: ServiceCapabilityToken.DigitalTwinProvider,
+    DigitalTwinReader: ServiceCapabilityToken.DigitalTwinReader,
+    /**
+     * @deprecated Prefer `IndexProvider`.
+     */
+    IndexingProvider: ServiceCapabilityToken.IndexProvider,
+    /**
+     * @deprecated Prefer `IndexReader`.
+     */
+    IndexingReader: ServiceCapabilityToken.IndexReader,
+};
+/**
+ * Parses the CSV stored in `org.schema.Service.serviceType`.
+ */
+export function parseServiceCapabilityTokens(value) {
+    return Array.from(new Set(String(value || '')
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean)));
+}
+/**
+ * Serializes capability tokens into the canonical CSV claim format.
+ */
+export function serializeServiceCapabilityTokens(values) {
+    const normalized = Array.from(new Set(values
+        .map((item) => String(item || '').trim())
+        .filter(Boolean)));
+    return normalized.length ? normalized.join(',') : undefined;
+}
+/**
+ * Returns the capability family prefix from a token.
+ */
+export function getServiceCapabilityFamily(value) {
+    const normalized = String(value || '').trim().toLowerCase();
+    if (!normalized)
+        return undefined;
+    return normalized.split('.')[0] || undefined;
+}
+/**
+ * Checks whether the claim contains at least one capability from the requested
+ * family.
+ */
+export function hasServiceCapabilityFamily(value, family) {
+    const normalizedFamily = String(family || '').trim().toLowerCase();
+    if (!normalizedFamily)
+        return false;
+    return parseServiceCapabilityTokens(value).some((item) => getServiceCapabilityFamily(item) === normalizedFamily);
+}
+/**
+ * Returns whether a capability token denotes a discoverable provider/service
+ * role rather than a reader-only role.
+ */
+export function isProviderServiceCapability(value) {
+    const normalized = String(value || '').trim().toLowerCase();
+    return normalized === ServiceCapabilityToken.IndexProvider
+        || normalized === ServiceCapabilityToken.DigitalTwinProvider;
+}

package/dist/gdc-common-utils-ts/src/constants/smart.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Canonical SMART/GW scope literals currently used by the CORE GW contract.
+ *
+ * These are gateway-specific scope strings, not a complete generic SMART
+ * terminology catalog.
+ */
+export declare const SmartGatewayScopesFhirR4: Readonly<{
+    /**
+     * Consent resource CRUDS scope used by the current GW SMART token flows.
+     */
+    readonly ConsentCruds: "organization/Consent.cruds";
+}>;

package/dist/gdc-common-utils-ts/src/constants/smart.js

@@ -0,0 +1,12 @@
+/**
+ * Canonical SMART/GW scope literals currently used by the CORE GW contract.
+ *
+ * These are gateway-specific scope strings, not a complete generic SMART
+ * terminology catalog.
+ */
+export const SmartGatewayScopesFhirR4 = Object.freeze({
+    /**
+     * Consent resource CRUDS scope used by the current GW SMART token flows.
+     */
+    ConsentCruds: 'organization/Consent.cruds',
+});

package/dist/gdc-common-utils-ts/src/constants/urn.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Canonical URN prefixes reused across bootstrap and proof examples.
+ *
+ * The JWK thumbprint URI prefix below follows RFC 9278 and is intended for
+ * cases where a key identifier is represented as a normalized URI instead of
+ * as a bare base64url thumbprint value.
+ */
+export declare const UrnPrefixes: Readonly<{
+    readonly JwkThumbprintSha256KeyId: "urn:ietf:params:oauth:jwk-thumbprint:sha-256:";
+}>;
+export type UrnPrefix = typeof UrnPrefixes[keyof typeof UrnPrefixes];

package/dist/gdc-common-utils-ts/src/constants/urn.js

@@ -0,0 +1,11 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+/**
+ * Canonical URN prefixes reused across bootstrap and proof examples.
+ *
+ * The JWK thumbprint URI prefix below follows RFC 9278 and is intended for
+ * cases where a key identifier is represented as a normalized URI instead of
+ * as a bare base64url thumbprint value.
+ */
+export const UrnPrefixes = Object.freeze({
+    JwkThumbprintSha256KeyId: 'urn:ietf:params:oauth:jwk-thumbprint:sha-256:',
+});

package/dist/gdc-common-utils-ts/src/constants/verifiable-credentials.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Canonical W3C credential contexts reused by activation/VP helpers and tests.
+ *
+ * Keep these values centralized so examples and unit suites do not re-hardcode
+ * W3C context URLs inline.
+ */
+export declare const W3cCredentialContexts: Readonly<{
+    V1: "https://www.w3.org/2018/credentials/v1";
+    V2: "https://www.w3.org/ns/credentials/v2";
+}>;
+/**
+ * Canonical W3C credential and presentation base types.
+ */
+export declare const W3cCredentialTypes: Readonly<{
+    VerifiableCredential: "VerifiableCredential";
+    VerifiablePresentation: "VerifiablePresentation";
+}>;
+/**
+ * Canonical activation VC subtype names currently accepted by CORE helpers.
+ *
+ * Notes:
+ * - `LegalOrganizationCredential` and `PersonCredential` remain accepted as
+ *   compatibility aliases while ICA/GW contracts converge.
+ * - Example/test code must import these constants instead of re-hardcoding the
+ *   subtype strings inline.
+ */
+export declare const ActivationCredentialTypes: Readonly<{
+    OrganizationCredential: "OrganizationCredential";
+    LegalOrganizationCredential: "LegalOrganizationCredential";
+    LegalRepresentativeCredential: "LegalRepresentativeCredential";
+    PersonCredential: "PersonCredential";
+}>;
+export declare const ORGANIZATION_ACTIVATION_VC_TYPES: readonly ("OrganizationCredential" | "LegalOrganizationCredential")[];
+export declare const REPRESENTATIVE_ACTIVATION_VC_TYPES: readonly ("LegalRepresentativeCredential" | "PersonCredential")[];

package/dist/gdc-common-utils-ts/src/constants/verifiable-credentials.js

@@ -0,0 +1,42 @@
+// Copyright 2026 Antifraud Services Inc. 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.
+/**
+ * Canonical W3C credential contexts reused by activation/VP helpers and tests.
+ *
+ * Keep these values centralized so examples and unit suites do not re-hardcode
+ * W3C context URLs inline.
+ */
+export const W3cCredentialContexts = Object.freeze({
+    V1: 'https://www.w3.org/2018/credentials/v1',
+    V2: 'https://www.w3.org/ns/credentials/v2',
+});
+/**
+ * Canonical W3C credential and presentation base types.
+ */
+export const W3cCredentialTypes = Object.freeze({
+    VerifiableCredential: 'VerifiableCredential',
+    VerifiablePresentation: 'VerifiablePresentation',
+});
+/**
+ * Canonical activation VC subtype names currently accepted by CORE helpers.
+ *
+ * Notes:
+ * - `LegalOrganizationCredential` and `PersonCredential` remain accepted as
+ *   compatibility aliases while ICA/GW contracts converge.
+ * - Example/test code must import these constants instead of re-hardcoding the
+ *   subtype strings inline.
+ */
+export const ActivationCredentialTypes = Object.freeze({
+    OrganizationCredential: 'OrganizationCredential',
+    LegalOrganizationCredential: 'LegalOrganizationCredential',
+    LegalRepresentativeCredential: 'LegalRepresentativeCredential',
+    PersonCredential: 'PersonCredential',
+});
+export const ORGANIZATION_ACTIVATION_VC_TYPES = Object.freeze([
+    ActivationCredentialTypes.OrganizationCredential,
+    ActivationCredentialTypes.LegalOrganizationCredential,
+]);
+export const REPRESENTATIVE_ACTIVATION_VC_TYPES = Object.freeze([
+    ActivationCredentialTypes.LegalRepresentativeCredential,
+    ActivationCredentialTypes.PersonCredential,
+]);

package/dist/gdc-common-utils-ts/src/constants/vital-signs.d.ts

@@ -0,0 +1,75 @@
+export type CodingDescriptor = Readonly<{
+    system: string;
+    code: string;
+    display?: string;
+    claim: string;
+}>;
+/**
+ * Canonical `Observation.category` descriptors for vital-sign observations.
+ */
+export declare const ObservationCategoryCodes: Readonly<{
+    readonly VitalSigns: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+}>;
+/**
+ * Canonical LOINC descriptors for the currently supported Vital Signs.
+ */
+export declare const VitalSignsCodes: Readonly<{
+    readonly HeartRate: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+    readonly BloodPressure: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+    readonly SystolicBloodPressure: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+    readonly DiastolicBloodPressure: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+    readonly BodyTemperature: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+}>;
+/**
+ * Canonical UCUM unit descriptors used by the supported Vital Signs.
+ */
+export declare const VitalSignsUnits: Readonly<{
+    readonly BeatsPerMinute: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+    readonly MillimeterOfMercury: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+    readonly Celsius: Readonly<{
+        system: string;
+        code: string;
+        display?: string;
+        claim: string;
+    }>;
+}>;

package/dist/gdc-common-utils-ts/src/constants/vital-signs.js

@@ -0,0 +1,33 @@
+import { FhirCodeSystems } from './fhir-code-systems';
+function defineCoding(system, code, display) {
+    return Object.freeze({
+        system,
+        code,
+        display,
+        claim: `${system}|${code}`,
+    });
+}
+/**
+ * Canonical `Observation.category` descriptors for vital-sign observations.
+ */
+export const ObservationCategoryCodes = Object.freeze({
+    VitalSigns: defineCoding(FhirCodeSystems.ObservationCategory, 'vital-signs', 'Vital Signs'),
+});
+/**
+ * Canonical LOINC descriptors for the currently supported Vital Signs.
+ */
+export const VitalSignsCodes = Object.freeze({
+    HeartRate: defineCoding(FhirCodeSystems.Loinc, '8867-4', 'Heart rate'),
+    BloodPressure: defineCoding(FhirCodeSystems.Loinc, '85354-9', 'Blood pressure panel'),
+    SystolicBloodPressure: defineCoding(FhirCodeSystems.Loinc, '8480-6', 'Systolic blood pressure'),
+    DiastolicBloodPressure: defineCoding(FhirCodeSystems.Loinc, '8462-4', 'Diastolic blood pressure'),
+    BodyTemperature: defineCoding(FhirCodeSystems.Loinc, '8310-5', 'Body temperature'),
+});
+/**
+ * Canonical UCUM unit descriptors used by the supported Vital Signs.
+ */
+export const VitalSignsUnits = Object.freeze({
+    BeatsPerMinute: defineCoding(FhirCodeSystems.Ucum, '/min', 'beats/minute'),
+    MillimeterOfMercury: defineCoding(FhirCodeSystems.Ucum, 'mm[Hg]', 'mmHg'),
+    Celsius: defineCoding(FhirCodeSystems.Ucum, 'Cel', 'degrees Celsius'),
+});

package/dist/gdc-common-utils-ts/src/examples/api-flow-examples.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Compatibility aggregator for shared API flow examples.
+ *
+ * Prefer importing from `gdc-common-utils-ts/examples` or the flow-specific modules
+ * in this folder. This file exists to avoid the overloaded term `contract`
+ * while preserving a stable migration target for older imports.
+ */
+export * from './shared';
+export * from './ica-activation-proof';
+export * from './organization-controller';
+export * from './individual-controller';
+export * from './professional';
+export * from './related-person';
+export * from './frontend-session';
+export * from './lifecycle';

package/dist/gdc-common-utils-ts/src/examples/api-flow-examples.js

@@ -0,0 +1,16 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+/**
+ * Compatibility aggregator for shared API flow examples.
+ *
+ * Prefer importing from `gdc-common-utils-ts/examples` or the flow-specific modules
+ * in this folder. This file exists to avoid the overloaded term `contract`
+ * while preserving a stable migration target for older imports.
+ */
+export * from './shared';
+export * from './ica-activation-proof';
+export * from './organization-controller';
+export * from './individual-controller';
+export * from './professional';
+export * from './related-person';
+export * from './frontend-session';
+export * from './lifecycle';

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

@@ -0,0 +1,22 @@
+import { BundleEntry, BundleJsonApi } from '../models/bundle';
+/**
+ * First developer use case:
+ * - edit a Consent entry inside a Communication-attached Bundle
+ * - keep active entry in memory
+ * - serialize full Bundle to Communication.content-attachment-data on save
+ * - release active entry memory when finished
+ */
+export declare function buildConsentEditingCommunicationSessionExample(): {
+    communicationClaims: Record<string, unknown>;
+    bundleInMemory: BundleJsonApi<BundleEntry>;
+};
+/**
+ * Second developer use case:
+ * - edit MedicationStatement claims to drive a health view
+ * - keep bundle attached to Communication as base64 payload
+ * - apply save/release lifecycle consistently
+ */
+export declare function buildMedicationEditingCommunicationSessionExample(): {
+    communicationClaims: Record<string, unknown>;
+    bundleInMemory: BundleJsonApi<BundleEntry>;
+};

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

@@ -0,0 +1,81 @@
+// 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 { HealthcareBasicSections } from '../constants/healthcare';
+import { CommunicationCategoryCodes } from '../constants/communication';
+import { ClaimConsent } from '../models/consent-rule';
+import { CommunicationClaim } from '../models/interoperable-claims/communication-claims';
+import { MedicationStatementClaim } from '../models/interoperable-claims/medication-statement-claims';
+import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_CONSENT_DATE, EXAMPLE_CONSENT_IDENTIFIER, EXAMPLE_CONSENT_PERIOD_END, EXAMPLE_CONSENT_PERIOD_START, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_CODE, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_SUBJECT_DID, } from './shared';
+import { CommunicationBundleSession } from '../utils/communication-bundle-session';
+/**
+ * First developer use case:
+ * - edit a Consent entry inside a Communication-attached Bundle
+ * - keep active entry in memory
+ * - serialize full Bundle to Communication.content-attachment-data on save
+ * - release active entry memory when finished
+ */
+export function buildConsentEditingCommunicationSessionExample() {
+    const session = new CommunicationBundleSession({
+        communicationClaims: {
+            '@context': 'org.hl7.fhir.r4',
+            [CommunicationClaim.Identifier]: EXAMPLE_COMMUNICATION_IDENTIFIER,
+            [CommunicationClaim.Subject]: EXAMPLE_SUBJECT_DID,
+            [CommunicationClaim.Category]: CommunicationCategoryCodes.Notification.claim,
+            [CommunicationClaim.Text]: EXAMPLE_IPS_BUNDLE_NOTE_TEXT,
+        },
+    });
+    session.upsertActiveConsentEntry({
+        claims: {
+            '@context': 'org.hl7.fhir.api',
+            [ClaimConsent.decision]: 'permit',
+            [ClaimConsent.subject]: EXAMPLE_SUBJECT_DID,
+            [ClaimConsent.identifier]: EXAMPLE_CONSENT_IDENTIFIER,
+            [ClaimConsent.date]: EXAMPLE_CONSENT_DATE,
+            [ClaimConsent.periodStart]: EXAMPLE_CONSENT_PERIOD_START,
+            [ClaimConsent.periodEnd]: EXAMPLE_CONSENT_PERIOD_END,
+            [ClaimConsent.purpose]: EXAMPLE_CONSENT_PURPOSE_TREATMENT,
+            [ClaimConsent.action]: HealthcareBasicSections.AllergiesAndIntolerances.claim,
+            [ClaimConsent.actorIdentifier]: EXAMPLE_EMAIL_PROFESSIONAL,
+            [ClaimConsent.actorRole]: EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN,
+        },
+        fullUrl: `urn:uuid:${EXAMPLE_CONSENT_IDENTIFIER}`,
+    });
+    session.saveAndReleaseActiveEntry();
+    return {
+        communicationClaims: session.getCommunicationClaims(),
+        bundleInMemory: session.getBundleInMemory(),
+    };
+}
+/**
+ * Second developer use case:
+ * - edit MedicationStatement claims to drive a health view
+ * - keep bundle attached to Communication as base64 payload
+ * - apply save/release lifecycle consistently
+ */
+export function buildMedicationEditingCommunicationSessionExample() {
+    const session = new CommunicationBundleSession({
+        communicationClaims: {
+            '@context': 'org.hl7.fhir.r4',
+            [CommunicationClaim.Identifier]: EXAMPLE_COMMUNICATION_IDENTIFIER,
+            [CommunicationClaim.Subject]: EXAMPLE_SUBJECT_DID,
+            [CommunicationClaim.Category]: CommunicationCategoryCodes.Reminder.claim,
+            [CommunicationClaim.Text]: EXAMPLE_IPS_BUNDLE_NOTE_TEXT,
+        },
+    });
+    session.upsertActiveMedicationStatementEntry({
+        claims: {
+            '@context': 'org.hl7.fhir.api',
+            [MedicationStatementClaim.Identifier]: EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER,
+            [MedicationStatementClaim.Subject]: EXAMPLE_SUBJECT_DID,
+            [MedicationStatementClaim.Status]: EXAMPLE_MEDICATION_STATEMENT_STATUS,
+            [MedicationStatementClaim.Code]: EXAMPLE_MEDICATION_STATEMENT_CODE,
+            [MedicationStatementClaim.MedicationText]: EXAMPLE_MEDICATION_STATEMENT_TEXT,
+        },
+        fullUrl: `urn:uuid:${EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER}`,
+    });
+    session.saveAndReleaseActiveEntry();
+    return {
+        communicationClaims: session.getCommunicationClaims(),
+        bundleInMemory: session.getBundleInMemory(),
+    };
+}

package/dist/gdc-common-utils-ts/src/examples/consent-access.d.ts

@@ -0,0 +1,30 @@
+import { ClaimConsent, type ConsentRule } from '../models/consent-rule';
+import { EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_EMAIL_RELATED_PERSON } from './shared';
+export declare const EXAMPLE_INDIVIDUAL_DID_WEB: "did:web:api.acme.org:individual:123";
+export declare const EXAMPLE_PROVIDER_ORGANIZATION_DID_WEB: "did:web:hospital.acme.org";
+export { EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_EMAIL_RELATED_PERSON };
+export declare const EXAMPLE_CONSENT_ACCESS_JURISDICTION: "ES";
+/**
+ * Legacy compatibility aliases kept so older docs/tests/imports continue to work
+ * while the canonical variable names converge.
+ */
+export declare const EXAMPLE_CONSENT_ACCESS_SUBJECT: "did:web:api.acme.org:individual:123";
+export declare const EXAMPLE_CONSENT_ACCESS_PROVIDER_DID: "did:web:hospital.acme.org";
+export declare const EXAMPLE_CONSENT_ACCESS_PROVIDER_EMAIL: "doctor.oncall@example.org";
+export declare const EXAMPLE_CONSENT_ACCESS_RELATED_PERSON_EMAIL: "parent.guardian@example.org";
+export declare const EXAMPLE_CONSENT_ACCESS_RULES: Readonly<{
+    physicianByEmailContinuousCare: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    physicianByEmailEmergency: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    physicianByOrganizationContinuousCare: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    physicianByJurisdictionEmergency: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    nurseByOrganization: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    paramedicByJurisdiction: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    directPhysicianDenyInsideAllowedOrganization: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    relatedPersonByEmail: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+    revokedPhysicianEmailConsent: ConsentRule & Partial<Record<ClaimConsent.resourceType, string>>;
+}>;
+export declare const EXAMPLE_CONSENT_PHONE_EXTENSION_PENDING: Readonly<{
+    target: "tel:+34600111222";
+    status: "pending-extension";
+    reason: "telephone actor targeting remains an extension concern unless the sector/runtime explicitly enables it";
+}>;

package/dist/gdc-common-utils-ts/src/examples/consent-access.js

@@ -0,0 +1,121 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { HealthcareActorRoles, HealthcareBasicSections, HealthcareConsentPurposes, } from '../constants/healthcare';
+import { ClaimConsent } from '../models/consent-rule';
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types';
+import { EXAMPLE_CONSENT_DATE, EXAMPLE_CONSENT_PERIOD_END, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_EMAIL_RELATED_PERSON, EXAMPLE_HEALTHCARE_JURISDICTION, EXAMPLE_PROVIDER_ORGANIZATION_DID, EXAMPLE_RELATED_PERSON_ROLE, EXAMPLE_SUBJECT_DID, } from './shared';
+export const EXAMPLE_INDIVIDUAL_DID_WEB = EXAMPLE_SUBJECT_DID;
+export const EXAMPLE_PROVIDER_ORGANIZATION_DID_WEB = EXAMPLE_PROVIDER_ORGANIZATION_DID;
+export { EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_EMAIL_RELATED_PERSON };
+export const EXAMPLE_CONSENT_ACCESS_JURISDICTION = EXAMPLE_HEALTHCARE_JURISDICTION;
+/**
+ * Legacy compatibility aliases kept so older docs/tests/imports continue to work
+ * while the canonical variable names converge.
+ */
+export const EXAMPLE_CONSENT_ACCESS_SUBJECT = EXAMPLE_INDIVIDUAL_DID_WEB;
+export const EXAMPLE_CONSENT_ACCESS_PROVIDER_DID = EXAMPLE_PROVIDER_ORGANIZATION_DID_WEB;
+export const EXAMPLE_CONSENT_ACCESS_PROVIDER_EMAIL = EXAMPLE_EMAIL_PROFESSIONAL;
+export const EXAMPLE_CONSENT_ACCESS_RELATED_PERSON_EMAIL = EXAMPLE_EMAIL_RELATED_PERSON;
+/**
+ * Consent example builder used by docs/tests.
+ *
+ * Contract note:
+ * repeated actor identifiers, dates, jurisdictions, role fixtures, and
+ * canonical consent claim keys must be imported, never re-hardcoded inline in
+ * each example rule.
+ */
+function buildRule(input) {
+    return {
+        '@context': 'org.hl7.fhir.api',
+        [ClaimConsent.identifier]: input.identifier,
+        [ClaimConsent.subject]: EXAMPLE_INDIVIDUAL_DID_WEB,
+        [ClaimConsent.actorIdentifier]: input.actorIdentifier,
+        [ClaimConsent.actorRole]: input.actorRole,
+        [ClaimConsent.decision]: input.decision || 'permit',
+        [ClaimConsent.purpose]: input.purpose,
+        [ClaimConsent.action]: input.actions.join(','),
+        ...(input.resourceTypes?.length ? { [ClaimConsent.resourceType]: input.resourceTypes.join(',') } : {}),
+        ...(input.periodStart ? { [ClaimConsent.periodStart]: input.periodStart } : {}),
+        ...(input.periodEnd ? { [ClaimConsent.periodEnd]: input.periodEnd } : {}),
+        [ClaimConsent.date]: EXAMPLE_CONSENT_DATE,
+    };
+}
+export const EXAMPLE_CONSENT_ACCESS_RULES = Object.freeze({
+    physicianByEmailContinuousCare: buildRule({
+        identifier: 'urn:uuid:consent-physician-email-treatment',
+        actorIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
+        actorRole: HealthcareActorRoles.Physician,
+        purpose: HealthcareConsentPurposes.Treatment,
+        actions: [HealthcareBasicSections.AllergiesAndIntolerances.claim],
+        resourceTypes: [ResourceTypesFhirR4.Composition, ResourceTypesFhirR4.AllergyIntolerance],
+    }),
+    physicianByEmailEmergency: buildRule({
+        identifier: 'urn:uuid:consent-physician-email-emergency',
+        actorIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
+        actorRole: HealthcareActorRoles.Physician,
+        purpose: HealthcareConsentPurposes.EmergencyTreatment,
+        actions: [HealthcareBasicSections.PatientSummaryDocument.claim],
+        resourceTypes: [ResourceTypesFhirR4.Composition, ResourceTypesFhirR4.DocumentReference],
+    }),
+    physicianByOrganizationContinuousCare: buildRule({
+        identifier: 'urn:uuid:consent-physician-org-treatment',
+        actorIdentifier: EXAMPLE_PROVIDER_ORGANIZATION_DID_WEB,
+        actorRole: HealthcareActorRoles.Physician,
+        purpose: HealthcareConsentPurposes.Treatment,
+        actions: [HealthcareBasicSections.Results.claim],
+        resourceTypes: [ResourceTypesFhirR4.Composition, ResourceTypesFhirR4.DiagnosticReport],
+    }),
+    physicianByJurisdictionEmergency: buildRule({
+        identifier: 'urn:uuid:consent-physician-jurisdiction-emergency',
+        actorIdentifier: EXAMPLE_CONSENT_ACCESS_JURISDICTION,
+        actorRole: HealthcareActorRoles.Physician,
+        purpose: HealthcareConsentPurposes.EmergencyTreatment,
+        actions: [HealthcareBasicSections.PatientSummaryDocument.claim],
+        resourceTypes: [ResourceTypesFhirR4.Composition, ResourceTypesFhirR4.DocumentReference],
+    }),
+    nurseByOrganization: buildRule({
+        identifier: 'urn:uuid:consent-nurse-org-treatment',
+        actorIdentifier: EXAMPLE_PROVIDER_ORGANIZATION_DID_WEB,
+        actorRole: HealthcareActorRoles.NursingProfessional,
+        purpose: HealthcareConsentPurposes.Treatment,
+        actions: [HealthcareBasicSections.HistoryOfMedicationUse.claim],
+        resourceTypes: [ResourceTypesFhirR4.Composition, ResourceTypesFhirR4.MedicationStatement],
+    }),
+    paramedicByJurisdiction: buildRule({
+        identifier: 'urn:uuid:consent-paramedic-jurisdiction-emergency',
+        actorIdentifier: EXAMPLE_CONSENT_ACCESS_JURISDICTION,
+        actorRole: HealthcareActorRoles.Paramedic,
+        purpose: HealthcareConsentPurposes.EmergencyTreatment,
+        actions: [HealthcareBasicSections.PatientSummaryDocument.claim],
+        resourceTypes: [ResourceTypesFhirR4.Composition, ResourceTypesFhirR4.Observation],
+    }),
+    directPhysicianDenyInsideAllowedOrganization: buildRule({
+        identifier: 'urn:uuid:consent-physician-direct-deny',
+        actorIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
+        actorRole: HealthcareActorRoles.Physician,
+        decision: 'deny',
+        purpose: HealthcareConsentPurposes.Treatment,
+        actions: [HealthcareBasicSections.Results.claim],
+        resourceTypes: [ResourceTypesFhirR4.DiagnosticReport],
+    }),
+    relatedPersonByEmail: buildRule({
+        identifier: 'urn:uuid:consent-related-person-email',
+        actorIdentifier: EXAMPLE_EMAIL_RELATED_PERSON,
+        actorRole: EXAMPLE_RELATED_PERSON_ROLE,
+        purpose: HealthcareConsentPurposes.Treatment,
+        actions: [HealthcareBasicSections.PatientSummaryDocument.claim],
+        resourceTypes: [ResourceTypesFhirR4.Composition, ResourceTypesFhirR4.DocumentReference],
+    }),
+    revokedPhysicianEmailConsent: buildRule({
+        identifier: 'urn:uuid:consent-physician-email-revoked',
+        actorIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
+        actorRole: HealthcareActorRoles.Physician,
+        purpose: HealthcareConsentPurposes.EmergencyTreatment,
+        actions: [HealthcareBasicSections.PatientSummaryDocument.claim],
+        periodEnd: EXAMPLE_CONSENT_PERIOD_END,
+    }),
+});
+export const EXAMPLE_CONSENT_PHONE_EXTENSION_PENDING = Object.freeze({
+    target: 'tel:+34600111222',
+    status: 'pending-extension',
+    reason: 'telephone actor targeting remains an extension concern unless the sector/runtime explicitly enables it',
+});

package/dist/gdc-common-utils-ts/src/examples/contract-examples.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Compatibility aggregator for shared contract examples.
+ *
+ * Prefer importing from `gdc-common-utils-ts/examples` or the flow-specific modules
+ * in this folder. This file exists so existing consumers can transition without
+ * breaking while the examples are reorganized by flow/case of use.
+ */
+export * from './shared';
+export * from './ica-activation-proof';
+export * from './organization-controller';
+export * from './individual-controller';
+export * from './professional';
+export * from './related-person';
+export * from './frontend-session';
+export * from './lifecycle';