gdc-sdk-front-ts 0.6.2 → 0.6.5

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

@@ -0,0 +1,40 @@
+// 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 actor-kind vocabulary shared across SDK packages.
+ */
+export const ActorKinds = Object.freeze({
+    HostOnboarding: 'host_onboarding',
+    OrganizationController: 'organization_controller',
+    OrganizationEmployee: 'organization_employee',
+    IndividualController: 'individual_controller',
+    IndividualMember: 'individual_member',
+    Professional: 'professional',
+});
+/**
+ * Canonical capability vocabulary shared across SDK packages.
+ */
+export const ActorCapabilities = Object.freeze({
+    HostActivateOrganization: 'host.activate_organization',
+    HostConfirmOrder: 'host.confirm_order',
+    OrganizationCreateEmployee: 'organization.create_employee',
+    OrganizationDisableEmployee: 'organization.disable_employee',
+    OrganizationPurgeEmployee: 'organization.purge_employee',
+    OrganizationActivateDevice: 'organization.activate_device',
+    OrganizationIssueActivationCode: 'organization.issue_activation_code',
+    OrganizationRequestSmartToken: 'organization.request_smart_token',
+    IndividualBootstrap: 'individual.bootstrap',
+    IndividualDisable: 'individual.disable',
+    IndividualPurge: 'individual.purge',
+    IndividualImportIps: 'individual.import_ips',
+    IndividualGenerateDigitalTwin: 'individual.generate_digital_twin',
+    IndividualIngestCommunication: 'individual.ingest_communication',
+    IndividualUpsertRelatedPerson: 'individual.upsert_related_person',
+    IndividualMemberDisable: 'individual_member.disable',
+    IndividualMemberPurge: 'individual_member.purge',
+    ConsentGrantProfessionalAccess: 'consent.grant_professional_access',
+    ProfessionalMedication: 'professional.medication',
+    ProfessionalAppointment: 'professional.appointment',
+    ProfessionalRequestSmartToken: 'professional.request_smart_token',
+    TokenRequestSmart: 'token.request_smart',
+});

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

@@ -0,0 +1,28 @@
+export declare const HL7_COMMUNICATION_CATEGORY_SYSTEM: "http://terminology.hl7.org/CodeSystem/communication-category";
+export type CommunicationCategoryDescriptor = Readonly<{
+    system: typeof HL7_COMMUNICATION_CATEGORY_SYSTEM;
+    code: string;
+    claim: string;
+}>;
+export declare const CommunicationCategoryCodes: Readonly<{
+    readonly Alert: Readonly<{
+        system: typeof HL7_COMMUNICATION_CATEGORY_SYSTEM;
+        code: string;
+        claim: string;
+    }>;
+    readonly Notification: Readonly<{
+        system: typeof HL7_COMMUNICATION_CATEGORY_SYSTEM;
+        code: string;
+        claim: string;
+    }>;
+    readonly Reminder: Readonly<{
+        system: typeof HL7_COMMUNICATION_CATEGORY_SYSTEM;
+        code: string;
+        claim: string;
+    }>;
+    readonly Instruction: Readonly<{
+        system: typeof HL7_COMMUNICATION_CATEGORY_SYSTEM;
+        code: string;
+        claim: string;
+    }>;
+}>;

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

@@ -0,0 +1,14 @@
+export const HL7_COMMUNICATION_CATEGORY_SYSTEM = 'http://terminology.hl7.org/CodeSystem/communication-category';
+function defineCommunicationCategory(code) {
+    return Object.freeze({
+        system: HL7_COMMUNICATION_CATEGORY_SYSTEM,
+        code,
+        claim: `${HL7_COMMUNICATION_CATEGORY_SYSTEM}|${code}`,
+    });
+}
+export const CommunicationCategoryCodes = Object.freeze({
+    Alert: defineCommunicationCategory('alert'),
+    Notification: defineCommunicationCategory('notification'),
+    Reminder: defineCommunicationCategory('reminder'),
+    Instruction: defineCommunicationCategory('instruction'),
+});

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

@@ -0,0 +1,58 @@
+import { MldsaAlg, MlkemCurve } from '../interfaces/Cryptography.types';
+/**
+ * Canonical JOSE/JWK `use` values used across GDC communication key material.
+ */
+export declare const JwkKeyUses: {
+    readonly Signature: "sig";
+    readonly Encryption: "enc";
+};
+/**
+ * Canonical public-key purposes used by GW and SDKs to distinguish communication
+ * signing keys from VC signing keys.
+ */
+export declare const CommunicationKeyPurposes: {
+    readonly CommunicationSignature: "comm_sig";
+    readonly VerifiableCredentialSignature: "vc_sign";
+};
+/**
+ * Classical JOSE signature algorithms currently recognized across GDC VP/JWT
+ * examples and gateway trust adapters.
+ *
+ * Notes:
+ * - `ES256K` is the JOSE name for ECDSA over `secp256k1`
+ * - `ES384` remains the common P-384 legacy example in current GW fixtures
+ */
+export declare const ClassicalJoseSignatureAlgorithms: {
+    readonly Es256: "ES256";
+    readonly Es256K: "ES256K";
+    readonly Es384: "ES384";
+};
+/**
+ * JOSE signature algorithms accepted by shared VP/JWT helpers.
+ *
+ * This intentionally covers both:
+ * - classical ECDSA JOSE algorithms (`ES256`, `ES256K`, `ES384`)
+ * - post-quantum ML-DSA JOSE algorithm labels already used by GW
+ *
+ * Use this type when a helper builds or documents a JWS/JWT/VP proof header.
+ */
+export type JoseSignatureAlgorithm = typeof ClassicalJoseSignatureAlgorithms[keyof typeof ClassicalJoseSignatureAlgorithms] | MldsaAlg;
+/**
+ * Default post-quantum signing algorithms used for communication bootstrap.
+ */
+export declare const DefaultSigningAlgorithms: {
+    Communication: MldsaAlg;
+    VerifiableCredential: MldsaAlg;
+};
+/**
+ * Default post-quantum encryption curve used for communication bootstrap.
+ */
+export declare const DefaultEncryptionCurves: {
+    Communication: MlkemCurve;
+};
+/**
+ * Canonical JOSE content-encryption algorithms used by DIDComm/JWE envelopes.
+ */
+export declare const JoseContentEncryptionAlgorithms: {
+    readonly Aes256Gcm: "A256GCM";
+};

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

@@ -0,0 +1,49 @@
+// Copyright 2025 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { AES_GCM_JWA_ENC } from '../models/aes';
+/**
+ * Canonical JOSE/JWK `use` values used across GDC communication key material.
+ */
+export const JwkKeyUses = {
+    Signature: 'sig',
+    Encryption: 'enc',
+};
+/**
+ * Canonical public-key purposes used by GW and SDKs to distinguish communication
+ * signing keys from VC signing keys.
+ */
+export const CommunicationKeyPurposes = {
+    CommunicationSignature: 'comm_sig',
+    VerifiableCredentialSignature: 'vc_sign',
+};
+/**
+ * Classical JOSE signature algorithms currently recognized across GDC VP/JWT
+ * examples and gateway trust adapters.
+ *
+ * Notes:
+ * - `ES256K` is the JOSE name for ECDSA over `secp256k1`
+ * - `ES384` remains the common P-384 legacy example in current GW fixtures
+ */
+export const ClassicalJoseSignatureAlgorithms = {
+    Es256: 'ES256',
+    Es256K: 'ES256K',
+    Es384: 'ES384',
+};
+/**
+ * Default post-quantum signing algorithms used for communication bootstrap.
+ */
+export const DefaultSigningAlgorithms = {
+    Communication: 'ML-DSA-44',
+    VerifiableCredential: 'ML-DSA-44',
+};
+/**
+ * Default post-quantum encryption curve used for communication bootstrap.
+ */
+export const DefaultEncryptionCurves = {
+    Communication: 'ML-KEM-768',
+};
+/**
+ * Canonical JOSE content-encryption algorithms used by DIDComm/JWE envelopes.
+ */
+export const JoseContentEncryptionAlgorithms = {
+    Aes256Gcm: AES_GCM_JWA_ENC,
+};

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

@@ -0,0 +1,11 @@
+/**
+ * Shared discovery-source policies used by backend/bootstrap layers that must
+ * decide whether to start from configured defaults or from live internet/ICA
+ * discovery.
+ */
+export declare const DataspaceDiscoverySourceMode: Readonly<{
+    readonly DefaultFirst: "default-first";
+    readonly DefaultsOnly: "defaults-only";
+    readonly InternetFirst: "internet-first";
+}>;
+export type DataspaceDiscoverySourceModeValue = typeof DataspaceDiscoverySourceMode[keyof typeof DataspaceDiscoverySourceMode];

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

@@ -0,0 +1,11 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+/**
+ * Shared discovery-source policies used by backend/bootstrap layers that must
+ * decide whether to start from configured defaults or from live internet/ICA
+ * discovery.
+ */
+export const DataspaceDiscoverySourceMode = Object.freeze({
+    DefaultFirst: 'default-first',
+    DefaultsOnly: 'defaults-only',
+    InternetFirst: 'internet-first',
+});

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

@@ -0,0 +1,27 @@
+/**
+ * Canonical Dataspace Protocol version identifiers used by the current GW/SDK
+ * discovery flows.
+ */
+export declare const DataspaceProtocolVersions: Readonly<{
+    readonly Current: "2025-1";
+}>;
+/**
+ * Canonical well-known paths used by Dataspace Protocol discovery.
+ */
+export declare const DataspaceWellKnownPaths: Readonly<{
+    readonly VersionMetadata: "/.well-known/dspace-version";
+}>;
+/**
+ * Project-local GW CORE DSP binding paths.
+ *
+ * These preserve the current internal API structure while still ending in the
+ * DSP catalog route shapes.
+ */
+export declare const GwDataspaceBindingPaths: Readonly<{
+    readonly Base: "/dsp";
+    readonly CatalogCollectionSuffix: "/catalog";
+    readonly CatalogRequestSuffix: "/catalog/request";
+    readonly CatalogArtifactSuffix: "/catalog/dcat.json";
+    readonly CatalogDatasetsPrefix: "/catalog/datasets";
+}>;
+export type DataspaceProtocolVersionValue = typeof DataspaceProtocolVersions[keyof typeof DataspaceProtocolVersions];

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

@@ -0,0 +1,27 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+/**
+ * Canonical Dataspace Protocol version identifiers used by the current GW/SDK
+ * discovery flows.
+ */
+export const DataspaceProtocolVersions = Object.freeze({
+    Current: '2025-1',
+});
+/**
+ * Canonical well-known paths used by Dataspace Protocol discovery.
+ */
+export const DataspaceWellKnownPaths = Object.freeze({
+    VersionMetadata: '/.well-known/dspace-version',
+});
+/**
+ * Project-local GW CORE DSP binding paths.
+ *
+ * These preserve the current internal API structure while still ending in the
+ * DSP catalog route shapes.
+ */
+export const GwDataspaceBindingPaths = Object.freeze({
+    Base: '/dsp',
+    CatalogCollectionSuffix: '/catalog',
+    CatalogRequestSuffix: '/catalog/request',
+    CatalogArtifactSuffix: '/catalog/dcat.json',
+    CatalogDatasetsPrefix: '/catalog/datasets',
+});

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

@@ -0,0 +1,16 @@
+/**
+ * Canonical user classes used by device licenses and frontend/backend SDK flows.
+ */
+export declare const DeviceUserClasses: Readonly<{
+    readonly Employee: "employee";
+    readonly Individual: "individual";
+}>;
+export type DeviceUserClass = typeof DeviceUserClasses[keyof typeof DeviceUserClasses];
+/**
+ * Canonical device/app form factors used by licensing and activation flows.
+ */
+export declare const DeviceAppTypes: Readonly<{
+    readonly Mobile: "mobile";
+    readonly Web: "web";
+}>;
+export type DeviceAppType = typeof DeviceAppTypes[keyof typeof DeviceAppTypes];

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

@@ -0,0 +1,15 @@
+// Copyright 2025 Antifraud Services Inc. under the Apache License, Version 2.0.
+/**
+ * Canonical user classes used by device licenses and frontend/backend SDK flows.
+ */
+export const DeviceUserClasses = Object.freeze({
+    Employee: 'employee',
+    Individual: 'individual',
+});
+/**
+ * Canonical device/app form factors used by licensing and activation flows.
+ */
+export const DeviceAppTypes = Object.freeze({
+    Mobile: 'mobile',
+    Web: 'web',
+});

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

@@ -0,0 +1,42 @@
+/**
+ * Canonical DID service fragments published by GW/SDK discovery surfaces.
+ */
+export declare const DidServiceIds: Readonly<{
+    readonly DidDocument: "#did-document";
+    readonly Jwks: "#jwks";
+    readonly OpenIdConfiguration: "#openid-configuration";
+    readonly SmartConfiguration: "#smart-configuration";
+    readonly SmartToken: "#identity:openid:smart:token";
+    readonly CredentialIssuer: "#openid-credential-issuer";
+    readonly CapabilityStatement: "#fhir:capabilitystatement";
+    readonly Catalog: "#catalog";
+}>;
+/**
+ * Canonical DID service types published by GW/SDK discovery surfaces.
+ */
+export declare const DidServiceTypes: Readonly<{
+    readonly LinkedDomains: "LinkedDomains";
+    readonly JsonWebKeyService2020: "JsonWebKeyService2020";
+    readonly OpenIdProvider: "OpenIdProvider";
+    readonly SmartOnFhirConfiguration: "SmartOnFhirConfiguration";
+    readonly ApiService: "ApiService";
+    readonly CredentialIssuer: "OpenIdCredentialIssuer";
+    readonly FhirCapabilityStatement: "CapabilityStatement";
+    readonly CatalogService: "CatalogService";
+}>;
+/**
+ * Canonical discovery capabilities used when selecting endpoints from a DID Document.
+ */
+export declare const DiscoveryCapabilities: Readonly<{
+    readonly DidDocument: "did-document";
+    readonly Jwks: "jwks";
+    readonly OpenIdConfiguration: "openid-configuration";
+    readonly SmartConfiguration: "smart-configuration";
+    readonly SmartToken: "smart-token";
+    readonly CredentialIssuer: "credential-issuer";
+    readonly CapabilityStatement: "capability-statement";
+    readonly Catalog: "catalog";
+}>;
+export type DidServiceId = typeof DidServiceIds[keyof typeof DidServiceIds];
+export type DidServiceType = typeof DidServiceTypes[keyof typeof DidServiceTypes];
+export type DiscoveryCapability = typeof DiscoveryCapabilities[keyof typeof DiscoveryCapabilities];

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

@@ -0,0 +1,40 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+/**
+ * Canonical DID service fragments published by GW/SDK discovery surfaces.
+ */
+export const DidServiceIds = Object.freeze({
+    DidDocument: '#did-document',
+    Jwks: '#jwks',
+    OpenIdConfiguration: '#openid-configuration',
+    SmartConfiguration: '#smart-configuration',
+    SmartToken: '#identity:openid:smart:token',
+    CredentialIssuer: '#openid-credential-issuer',
+    CapabilityStatement: '#fhir:capabilitystatement',
+    Catalog: '#catalog',
+});
+/**
+ * Canonical DID service types published by GW/SDK discovery surfaces.
+ */
+export const DidServiceTypes = Object.freeze({
+    LinkedDomains: 'LinkedDomains',
+    JsonWebKeyService2020: 'JsonWebKeyService2020',
+    OpenIdProvider: 'OpenIdProvider',
+    SmartOnFhirConfiguration: 'SmartOnFhirConfiguration',
+    ApiService: 'ApiService',
+    CredentialIssuer: 'OpenIdCredentialIssuer',
+    FhirCapabilityStatement: 'CapabilityStatement',
+    CatalogService: 'CatalogService',
+});
+/**
+ * Canonical discovery capabilities used when selecting endpoints from a DID Document.
+ */
+export const DiscoveryCapabilities = Object.freeze({
+    DidDocument: 'did-document',
+    Jwks: 'jwks',
+    OpenIdConfiguration: 'openid-configuration',
+    SmartConfiguration: 'smart-configuration',
+    SmartToken: 'smart-token',
+    CredentialIssuer: 'credential-issuer',
+    CapabilityStatement: 'capability-statement',
+    Catalog: 'catalog',
+});

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

@@ -0,0 +1,36 @@
+/**
+ * ISO 3166-1 alpha-2 country codes that currently belong to the European Union.
+ *
+ * This list is intentionally kept in a runtime-neutral shared package because
+ * dataspace discovery may need to infer a broader coverage scope such as `EU`
+ * from the semantic country carried in a VC `credentialSubject`.
+ */
+export declare const EU_COUNTRY_CODES: readonly ["AT", "BE", "BG", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "DE", "GR", "HU", "IE", "IT", "LV", "LT", "LU", "MT", "NL", "PL", "PT", "RO", "SK", "SI", "ES", "SE"];
+export type EuCountryCode = typeof EU_COUNTRY_CODES[number];
+/**
+ * Normalizes a country code into canonical uppercase ISO-2 form.
+ *
+ * @param countryCode Country code from `credentialSubject.address.addressCountry`
+ * or the flattened operational projection.
+ * @returns Uppercase ISO-2 form or an empty string when the input is blank.
+ *
+ * @example
+ * ```ts
+ * normalizeCountryCode('es');
+ * // 'ES'
+ * ```
+ */
+export declare function normalizeCountryCode(countryCode: string | undefined | null): string;
+/**
+ * Checks whether the supplied country code belongs to the current EU member set.
+ *
+ * @param countryCode ISO-2 country code to evaluate.
+ * @returns `true` when the normalized code belongs to `EU_COUNTRY_CODES`.
+ *
+ * @example
+ * ```ts
+ * isEuCountryCode('ES');
+ * // true
+ * ```
+ */
+export declare function isEuCountryCode(countryCode: string | undefined | null): boolean;

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

@@ -0,0 +1,69 @@
+// Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+/**
+ * ISO 3166-1 alpha-2 country codes that currently belong to the European Union.
+ *
+ * This list is intentionally kept in a runtime-neutral shared package because
+ * dataspace discovery may need to infer a broader coverage scope such as `EU`
+ * from the semantic country carried in a VC `credentialSubject`.
+ */
+export const EU_COUNTRY_CODES = Object.freeze([
+    'AT',
+    'BE',
+    'BG',
+    'HR',
+    'CY',
+    'CZ',
+    'DK',
+    'EE',
+    'FI',
+    'FR',
+    'DE',
+    'GR',
+    'HU',
+    'IE',
+    'IT',
+    'LV',
+    'LT',
+    'LU',
+    'MT',
+    'NL',
+    'PL',
+    'PT',
+    'RO',
+    'SK',
+    'SI',
+    'ES',
+    'SE',
+]);
+/**
+ * Normalizes a country code into canonical uppercase ISO-2 form.
+ *
+ * @param countryCode Country code from `credentialSubject.address.addressCountry`
+ * or the flattened operational projection.
+ * @returns Uppercase ISO-2 form or an empty string when the input is blank.
+ *
+ * @example
+ * ```ts
+ * normalizeCountryCode('es');
+ * // 'ES'
+ * ```
+ */
+export function normalizeCountryCode(countryCode) {
+    return String(countryCode || '').trim().toUpperCase();
+}
+/**
+ * Checks whether the supplied country code belongs to the current EU member set.
+ *
+ * @param countryCode ISO-2 country code to evaluate.
+ * @returns `true` when the normalized code belongs to `EU_COUNTRY_CODES`.
+ *
+ * @example
+ * ```ts
+ * isEuCountryCode('ES');
+ * // true
+ * ```
+ */
+export function isEuCountryCode(countryCode) {
+    const normalized = normalizeCountryCode(countryCode);
+    return normalized ? EU_COUNTRY_CODES.includes(normalized) : false;
+}

package/dist/gdc-common-utils-ts/src/constants/fhir-code-systems.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Canonical FHIR/HL7 code system URLs shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline system strings when building
+ * FHIR codings, filters, or test fixtures.
+ */
+export declare const FhirCodeSystems: Readonly<{
+    readonly Loinc: "http://loinc.org";
+    readonly Ucum: "http://unitsofmeasure.org";
+    readonly CommunicationCategory: "http://terminology.hl7.org/CodeSystem/communication-category";
+    readonly ObservationCategory: "http://terminology.hl7.org/CodeSystem/observation-category";
+}>;

package/dist/gdc-common-utils-ts/src/constants/fhir-code-systems.js

@@ -0,0 +1,12 @@
+/**
+ * Canonical FHIR/HL7 code system URLs shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline system strings when building
+ * FHIR codings, filters, or test fixtures.
+ */
+export const FhirCodeSystems = Object.freeze({
+    Loinc: 'http://loinc.org',
+    Ucum: 'http://unitsofmeasure.org',
+    CommunicationCategory: 'http://terminology.hl7.org/CodeSystem/communication-category',
+    ObservationCategory: 'http://terminology.hl7.org/CodeSystem/observation-category',
+});

package/dist/gdc-common-utils-ts/src/constants/fhir-resource-types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Canonical FHIR R4 `resourceType` names shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline strings such as `"Observation"`
+ * or `"DocumentReference"` when building bundles, filters, or SDK facades.
+ */
+export declare const ResourceTypesFhirR4: Readonly<{
+    readonly AdverseEvent: "AdverseEvent";
+    readonly AllergyIntolerance: "AllergyIntolerance";
+    readonly Appointment: "Appointment";
+    readonly Bundle: "Bundle";
+    readonly CarePlan: "CarePlan";
+    readonly Communication: "Communication";
+    readonly Composition: "Composition";
+    readonly Condition: "Condition";
+    readonly Consent: "Consent";
+    readonly DiagnosticReport: "DiagnosticReport";
+    readonly DocumentReference: "DocumentReference";
+    readonly Encounter: "Encounter";
+    readonly ImagingStudy: "ImagingStudy";
+    readonly Immunization: "Immunization";
+    readonly MedicationStatement: "MedicationStatement";
+    readonly Observation: "Observation";
+    readonly Procedure: "Procedure";
+    readonly RelatedPerson: "RelatedPerson";
+}>;
+/**
+ * Backwards-compatible alias for the former generic name.
+ *
+ * Prefer `ResourceTypesFhirR4` in new code so later R5/R6 catalogs can coexist
+ * without ambiguity.
+ */
+export declare const FhirResourceTypes: Readonly<{
+    readonly AdverseEvent: "AdverseEvent";
+    readonly AllergyIntolerance: "AllergyIntolerance";
+    readonly Appointment: "Appointment";
+    readonly Bundle: "Bundle";
+    readonly CarePlan: "CarePlan";
+    readonly Communication: "Communication";
+    readonly Composition: "Composition";
+    readonly Condition: "Condition";
+    readonly Consent: "Consent";
+    readonly DiagnosticReport: "DiagnosticReport";
+    readonly DocumentReference: "DocumentReference";
+    readonly Encounter: "Encounter";
+    readonly ImagingStudy: "ImagingStudy";
+    readonly Immunization: "Immunization";
+    readonly MedicationStatement: "MedicationStatement";
+    readonly Observation: "Observation";
+    readonly Procedure: "Procedure";
+    readonly RelatedPerson: "RelatedPerson";
+}>;

package/dist/gdc-common-utils-ts/src/constants/fhir-resource-types.js

@@ -0,0 +1,33 @@
+/**
+ * Canonical FHIR R4 `resourceType` names shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline strings such as `"Observation"`
+ * or `"DocumentReference"` when building bundles, filters, or SDK facades.
+ */
+export const ResourceTypesFhirR4 = Object.freeze({
+    AdverseEvent: 'AdverseEvent',
+    AllergyIntolerance: 'AllergyIntolerance',
+    Appointment: 'Appointment',
+    Bundle: 'Bundle',
+    CarePlan: 'CarePlan',
+    Communication: 'Communication',
+    Composition: 'Composition',
+    Condition: 'Condition',
+    Consent: 'Consent',
+    DiagnosticReport: 'DiagnosticReport',
+    DocumentReference: 'DocumentReference',
+    Encounter: 'Encounter',
+    ImagingStudy: 'ImagingStudy',
+    Immunization: 'Immunization',
+    MedicationStatement: 'MedicationStatement',
+    Observation: 'Observation',
+    Procedure: 'Procedure',
+    RelatedPerson: 'RelatedPerson',
+});
+/**
+ * Backwards-compatible alias for the former generic name.
+ *
+ * Prefer `ResourceTypesFhirR4` in new code so later R5/R6 catalogs can coexist
+ * without ambiguity.
+ */
+export const FhirResourceTypes = ResourceTypesFhirR4;

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

@@ -0,0 +1,10 @@
+/**
+ * Canonical FHIR version labels shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline strings such as `"4.0"` or `"5.0"`.
+ */
+export declare const FhirVersions: Readonly<{
+    readonly R4: "4.0";
+    readonly R401: "4.0.1";
+    readonly R5: "5.0";
+}>;

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

@@ -0,0 +1,10 @@
+/**
+ * Canonical FHIR version labels shared across GW and SDK packages.
+ *
+ * Use these constants instead of inline strings such as `"4.0"` or `"5.0"`.
+ */
+export const FhirVersions = Object.freeze({
+    R4: '4.0',
+    R401: '4.0.1',
+    R5: '5.0',
+});