gdc-common-utils-ts 1.18.1 → 1.20.0

package/dist/constants/identity-gender.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Common gender/sex identity enumerations shared by tests and mappers.
+ *
+ * This module is designed to remove string literals from tests and to
+ * unify the semantics between different layers:
+ * - BirthSex (F/M)
+ * - AdministrativeSex (F/M/O; Other unified as O)
+ * - GenderIdentity (FHIR PCORNet-style codes, with Other handled as OT)
+ */
+/** BirthSex can only be "F", "M" or "U". */
+export declare enum BirthSex {
+    /** Female */
+    Female = "F",
+    /** Male */
+    Male = "M",
+    /** Unknown / not available in source data. */
+    Unknown = "U"
+}
+/**
+ * PCORNet Gender Identity terminology.
+ * https://hl7.org/fhir/us/cdmh/ValueSet-pcornet-gender-identity.html
+ */
+export declare enum GenderIdentity {
+    /** Gender identity is a Man. */
+    Man = "M",
+    /** Gender identity is a Woman. */
+    Woman = "F",
+    /** Transgender male or Transman or Female-to-Male. */
+    TransgenderMale = "TM",
+    /** Transgender female or Transwoman or Male-to-female. */
+    TransgenderFemale = "TF",
+    /** Gender identity is Genderqueer/Non-binary. */
+    GenderqueerNonBinary = "GQ",
+    /** Gender identity is Something else. */
+    SomethingElse = "SE",
+    /** Gender identity is Multiple gender categories. */
+    MultipleGenderCategories = "MU",
+    /** Person has declined to answer about their gender identity. */
+    DeclineToAnswer = "DC",
+    /** There is no information about the Person's gender identity. */
+    NoInformation = "NI",
+    /** Person's gender identity is unknown. */
+    Unknown = "UN",
+    /** Gender identity is Other. */
+    Other = "OT"
+}

package/dist/constants/identity-gender.js

@@ -0,0 +1,48 @@
+/**
+ * Common gender/sex identity enumerations shared by tests and mappers.
+ *
+ * This module is designed to remove string literals from tests and to
+ * unify the semantics between different layers:
+ * - BirthSex (F/M)
+ * - AdministrativeSex (F/M/O; Other unified as O)
+ * - GenderIdentity (FHIR PCORNet-style codes, with Other handled as OT)
+ */
+/** BirthSex can only be "F", "M" or "U". */
+export var BirthSex;
+(function (BirthSex) {
+    /** Female */
+    BirthSex["Female"] = "F";
+    /** Male */
+    BirthSex["Male"] = "M";
+    /** Unknown / not available in source data. */
+    BirthSex["Unknown"] = "U";
+})(BirthSex || (BirthSex = {}));
+/**
+ * PCORNet Gender Identity terminology.
+ * https://hl7.org/fhir/us/cdmh/ValueSet-pcornet-gender-identity.html
+ */
+export var GenderIdentity;
+(function (GenderIdentity) {
+    /** Gender identity is a Man. */
+    GenderIdentity["Man"] = "M";
+    /** Gender identity is a Woman. */
+    GenderIdentity["Woman"] = "F";
+    /** Transgender male or Transman or Female-to-Male. */
+    GenderIdentity["TransgenderMale"] = "TM";
+    /** Transgender female or Transwoman or Male-to-female. */
+    GenderIdentity["TransgenderFemale"] = "TF";
+    /** Gender identity is Genderqueer/Non-binary. */
+    GenderIdentity["GenderqueerNonBinary"] = "GQ";
+    /** Gender identity is Something else. */
+    GenderIdentity["SomethingElse"] = "SE";
+    /** Gender identity is Multiple gender categories. */
+    GenderIdentity["MultipleGenderCategories"] = "MU";
+    /** Person has declined to answer about their gender identity. */
+    GenderIdentity["DeclineToAnswer"] = "DC";
+    /** There is no information about the Person's gender identity. */
+    GenderIdentity["NoInformation"] = "NI";
+    /** Person's gender identity is unknown. */
+    GenderIdentity["Unknown"] = "UN";
+    /** Gender identity is Other. */
+    GenderIdentity["Other"] = "OT";
+})(GenderIdentity || (GenderIdentity = {}));

package/dist/constants/identity-identifiers.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Canonical identifier kinds reused by onboarding forms, KYC mappers, and
+ * frontend/backend tests.
+ *
+ * Source semantics:
+ * - ISO identifiers keep their reverse-DNS namespace
+ * - HL7 v2-0203 identifier types are normalized to reverse-DNS strings
+ *
+ * Design rule:
+ * - tests must import these values instead of hardcoding identifier type
+ *   strings inline
+ * - onboarding form fields may still accept legacy provider strings, but new
+ *   code should author `IdKind` values
+ *
+ * Reference:
+ * http://terminology.hl7.org/CodeSystem/v2-0203
+ */
+export declare enum IdKind {
+    /** ISO 18013-5 mobile driving licence credential. */
+    MobileDriverLicense = "org.iso.18013.5.1.mDL",
+    /** HL7 driver license identifier. */
+    PersonalDriverLicense = "org.hl7.terminology.codesystem.v2-0203.DL",
+    /** HL7 citizenship card identifier. */
+    PersonalCitizenshipCard = "org.hl7.terminology.codesystem.v2-0203.CZ",
+    /** HL7 national identity number. */
+    PersonalNationalNumber = "org.hl7.terminology.codesystem.v2-0203.NN",
+    /** HL7 jurisdictional health number. */
+    RegionalHeathCardNumber = "org.hl7.terminology.codesystem.v2-0203.JHN",
+    /** HL7 local/private health card identifier. */
+    LocalHealthCard = "org.hl7.terminology.codesystem.v2-0203.HC",
+    /** HL7 donor record identifier. */
+    LocalDonorRecord = "org.hl7.terminology.codesystem.v2-0203.DR",
+    /** HL7 local patient identifier. */
+    LocalPatientIdentifier = "org.hl7.terminology.codesystem.v2-0203.PI"
+}
+/** Union helper for code that wants typed values without depending on the enum object. */
+export type IdKindValue = typeof IdKind[keyof typeof IdKind];

package/dist/constants/identity-identifiers.js

@@ -0,0 +1,36 @@
+/**
+ * Canonical identifier kinds reused by onboarding forms, KYC mappers, and
+ * frontend/backend tests.
+ *
+ * Source semantics:
+ * - ISO identifiers keep their reverse-DNS namespace
+ * - HL7 v2-0203 identifier types are normalized to reverse-DNS strings
+ *
+ * Design rule:
+ * - tests must import these values instead of hardcoding identifier type
+ *   strings inline
+ * - onboarding form fields may still accept legacy provider strings, but new
+ *   code should author `IdKind` values
+ *
+ * Reference:
+ * http://terminology.hl7.org/CodeSystem/v2-0203
+ */
+export var IdKind;
+(function (IdKind) {
+    /** ISO 18013-5 mobile driving licence credential. */
+    IdKind["MobileDriverLicense"] = "org.iso.18013.5.1.mDL";
+    /** HL7 driver license identifier. */
+    IdKind["PersonalDriverLicense"] = "org.hl7.terminology.codesystem.v2-0203.DL";
+    /** HL7 citizenship card identifier. */
+    IdKind["PersonalCitizenshipCard"] = "org.hl7.terminology.codesystem.v2-0203.CZ";
+    /** HL7 national identity number. */
+    IdKind["PersonalNationalNumber"] = "org.hl7.terminology.codesystem.v2-0203.NN";
+    /** HL7 jurisdictional health number. */
+    IdKind["RegionalHeathCardNumber"] = "org.hl7.terminology.codesystem.v2-0203.JHN";
+    /** HL7 local/private health card identifier. */
+    IdKind["LocalHealthCard"] = "org.hl7.terminology.codesystem.v2-0203.HC";
+    /** HL7 donor record identifier. */
+    IdKind["LocalDonorRecord"] = "org.hl7.terminology.codesystem.v2-0203.DR";
+    /** HL7 local patient identifier. */
+    IdKind["LocalPatientIdentifier"] = "org.hl7.terminology.codesystem.v2-0203.PI";
+})(IdKind || (IdKind = {}));

package/dist/constants/index.d.ts

@@ -21,3 +21,5 @@ export * from './permission-templates';
 export * from './service-capabilities';
 export * from './urn';
 export * from './verifiable-credentials';
+export * from './identity-gender';
+export * from './identity-identifiers';

package/dist/constants/index.js

@@ -21,3 +21,5 @@ export * from './permission-templates.js';
 export * from './service-capabilities.js';
 export * from './urn.js';
 export * from './verifiable-credentials.js';
+export * from './identity-gender.js';
+export * from './identity-identifiers.js';

package/dist/constants/kyc-gender.d.ts

@@ -0,0 +1,50 @@
+import { BirthSex, GenderIdentity } from './identity-gender';
+/**
+ * Centralized, typed fixtures and contract helpers for KYC gender.
+ *
+ * Goal:
+ * - tests must never hardcode gender strings
+ * - production mapping must reuse the same canonical tokens
+ * - normalize input values that come from KYC providers / UI forms
+ *
+ * Contract note:
+ * - output values match the compact values already used by
+ *   `org.schema.Person.gender` claim tests and onboarding flows.
+ */
+/**
+ * Canonical compact gender used by onboarding claims.
+ *
+ * This is intentionally aligned with the current `org.schema.Person.gender`
+ * contract in tests (values `'M'` / `'F'`).
+ */
+export type CompactKycGender = BirthSex.Female | BirthSex.Male;
+/** Canonical compact gender token: male. */
+export declare const KYC_COMPACT_GENDER_MALE = BirthSex.Male;
+/** Canonical compact gender token: female. */
+export declare const KYC_COMPACT_GENDER_FEMALE = BirthSex.Female;
+/**
+ * Provider/UI gender inputs supported by normalization.
+ *
+ * These variants are expected to be already in English (as per your rules).
+ * If new languages appear, they should go through a dedicated
+ * intermediate normalization layer.
+ */
+export type EnglishKycGenderInput = 'female' | 'female' | 'mujer' | 'woman' | 'male' | 'man' | 'hombre' | 'F' | 'M';
+/** Provider/UI inputs mapped to compact gender (female). */
+export declare const KYC_GENDER_INPUT_FEMALE: "female";
+export declare const KYC_GENDER_INPUT_WOMAN = GenderIdentity.Woman;
+export declare const KYC_GENDER_INPUT_MUJER: "mujer";
+/** Provider/UI inputs mapped to compact gender (male). */
+export declare const KYC_GENDER_INPUT_MALE: "male";
+export declare const KYC_GENDER_INPUT_MAN = GenderIdentity.Man;
+export declare const KYC_GENDER_INPUT_HOMBRE: "hombre";
+/** Direct compact inputs (already normalized by some providers). */
+export declare const KYC_GENDER_INPUT_COMPACT_FEMALE = BirthSex.Female;
+export declare const KYC_GENDER_INPUT_COMPACT_MALE = BirthSex.Male;
+/**
+ * Normalizes heterogeneous KYC gender values to the compact contract.
+ *
+ * Implementation mirrors the previous behavior from
+ * `src/utils/individual-organization-kyc.ts`, but centralized.
+ */
+export declare function normalizeKycGenderToCompact(value: unknown): CompactKycGender | undefined;

package/dist/constants/kyc-gender.js

@@ -0,0 +1,43 @@
+import { BirthSex, GenderIdentity } from './identity-gender.js';
+/** Canonical compact gender token: male. */
+export const KYC_COMPACT_GENDER_MALE = BirthSex.Male;
+/** Canonical compact gender token: female. */
+export const KYC_COMPACT_GENDER_FEMALE = BirthSex.Female;
+/** Provider/UI inputs mapped to compact gender (female). */
+export const KYC_GENDER_INPUT_FEMALE = 'female';
+export const KYC_GENDER_INPUT_WOMAN = GenderIdentity.Woman;
+export const KYC_GENDER_INPUT_MUJER = 'mujer';
+/** Provider/UI inputs mapped to compact gender (male). */
+export const KYC_GENDER_INPUT_MALE = 'male';
+export const KYC_GENDER_INPUT_MAN = GenderIdentity.Man;
+export const KYC_GENDER_INPUT_HOMBRE = 'hombre';
+/** Direct compact inputs (already normalized by some providers). */
+export const KYC_GENDER_INPUT_COMPACT_FEMALE = BirthSex.Female;
+export const KYC_GENDER_INPUT_COMPACT_MALE = BirthSex.Male;
+/**
+ * Normalizes heterogeneous KYC gender values to the compact contract.
+ *
+ * Implementation mirrors the previous behavior from
+ * `src/utils/individual-organization-kyc.ts`, but centralized.
+ */
+export function normalizeKycGenderToCompact(value) {
+    const raw = typeof value === 'string' ? value.trim() : '';
+    if (!raw)
+        return undefined;
+    const normalized = raw.toLowerCase();
+    if (normalized === 'f'
+        || normalized === 'female'
+        || normalized === 'woman'
+        || normalized === 'mujer') {
+        return KYC_COMPACT_GENDER_FEMALE;
+    }
+    if (normalized === 'm'
+        || normalized === 'male'
+        || normalized === 'man'
+        || normalized === 'hombre') {
+        return KYC_COMPACT_GENDER_MALE;
+    }
+    // Fallback preserves unknown provider tokens by uppercasing; this keeps
+    // the previous contract where unmapped values become uppercased tokens.
+    return raw.toUpperCase();
+}

package/dist/constants/schemaorg.d.ts

@@ -1,6 +1,7 @@
 import { ParameterData } from "../models/params";
 export declare enum ClaimsServiceSchemaorg {
     areaServed = "org.schema.Service.areaServed",
+    additionalType = "org.schema.Service.additionalType",
     category = "org.schema.Service.category",
     identifier = "org.schema.Service.identifier",
     serviceType = "org.schema.Service.serviceType",
@@ -74,11 +75,24 @@ export declare enum ClaimsOrganizationSchemaorg {
      */
     hasCredentialMaterial = "org.schema.Organization.hasCredential.material",
     /** Individual/family owner email used by subject-index registration flows. */
+    ownerAlternateName = "org.schema.Organization.owner.alternateName",
+    /** Individual/family owner email used by subject-index registration flows. */
     ownerEmail = "org.schema.Organization.owner.email",
     /** Individual/family owner telephone used by subject-index registration flows. */
     ownerTelephone = "org.schema.Organization.owner.telephone",
     /** Individual/family owner legal identifier used by subject-index registration flows. */
     ownerIdentifierValue = "org.schema.Organization.owner.identifier.value",
+    /** Individual/family indexed member friendly name used by onboarding draft helpers. */
+    memberAlternateName = "org.schema.Organization.member.alternateName",
+    memberGivenName = "org.schema.Organization.member.givenName",
+    memberFamilyName = "org.schema.Organization.member.familyName",
+    memberBirthDate = "org.schema.Organization.member.birthDate",
+    memberGender = "org.schema.Organization.member.gender",
+    memberEmail = "org.schema.Organization.member.email",
+    memberTelephone = "org.schema.Organization.member.telephone",
+    memberIdentifierType = "org.schema.Organization.member.identifier.additionalType",
+    memberIdentifierValue = "org.schema.Organization.member.identifier.value",
+    memberRole = "org.schema.Organization.member.role",
     numberOfEmployees = "org.schema.Organization.numberOfEmployees.value"
 }
 export declare enum ClaimsOfferSchemaorg {
@@ -95,6 +109,9 @@ export declare enum ClaimsOfferSchemaorg {
     priceCurrency = "org.schema.Offer.priceCurrency",
     serialNumber = "org.schema.Offer.serialNumber"
 }
+export declare enum ClaimsOrderSchemaorg {
+    orderedItemServiceType = "org.schema.Order.orderedItem.serviceType"
+}
 /** For Employees (and Employee Role, but no PII) and customers / related persons.
  * - `givenName`: The given name of the person.
  * - `familyName`: The primary family name or surname of the person.

package/dist/constants/schemaorg.js

@@ -3,6 +3,7 @@
 export var ClaimsServiceSchemaorg;
 (function (ClaimsServiceSchemaorg) {
     ClaimsServiceSchemaorg["areaServed"] = "org.schema.Service.areaServed";
+    ClaimsServiceSchemaorg["additionalType"] = "org.schema.Service.additionalType";
     ClaimsServiceSchemaorg["category"] = "org.schema.Service.category";
     ClaimsServiceSchemaorg["identifier"] = "org.schema.Service.identifier";
     ClaimsServiceSchemaorg["serviceType"] = "org.schema.Service.serviceType";
@@ -78,11 +79,24 @@ export var ClaimsOrganizationSchemaorg;
      */
     ClaimsOrganizationSchemaorg["hasCredentialMaterial"] = "org.schema.Organization.hasCredential.material";
     /** Individual/family owner email used by subject-index registration flows. */
+    ClaimsOrganizationSchemaorg["ownerAlternateName"] = "org.schema.Organization.owner.alternateName";
+    /** Individual/family owner email used by subject-index registration flows. */
     ClaimsOrganizationSchemaorg["ownerEmail"] = "org.schema.Organization.owner.email";
     /** Individual/family owner telephone used by subject-index registration flows. */
     ClaimsOrganizationSchemaorg["ownerTelephone"] = "org.schema.Organization.owner.telephone";
     /** Individual/family owner legal identifier used by subject-index registration flows. */
     ClaimsOrganizationSchemaorg["ownerIdentifierValue"] = "org.schema.Organization.owner.identifier.value";
+    /** Individual/family indexed member friendly name used by onboarding draft helpers. */
+    ClaimsOrganizationSchemaorg["memberAlternateName"] = "org.schema.Organization.member.alternateName";
+    ClaimsOrganizationSchemaorg["memberGivenName"] = "org.schema.Organization.member.givenName";
+    ClaimsOrganizationSchemaorg["memberFamilyName"] = "org.schema.Organization.member.familyName";
+    ClaimsOrganizationSchemaorg["memberBirthDate"] = "org.schema.Organization.member.birthDate";
+    ClaimsOrganizationSchemaorg["memberGender"] = "org.schema.Organization.member.gender";
+    ClaimsOrganizationSchemaorg["memberEmail"] = "org.schema.Organization.member.email";
+    ClaimsOrganizationSchemaorg["memberTelephone"] = "org.schema.Organization.member.telephone";
+    ClaimsOrganizationSchemaorg["memberIdentifierType"] = "org.schema.Organization.member.identifier.additionalType";
+    ClaimsOrganizationSchemaorg["memberIdentifierValue"] = "org.schema.Organization.member.identifier.value";
+    ClaimsOrganizationSchemaorg["memberRole"] = "org.schema.Organization.member.role";
     ClaimsOrganizationSchemaorg["numberOfEmployees"] = "org.schema.Organization.numberOfEmployees.value"; // to purchase licenses for device profile's activation
 })(ClaimsOrganizationSchemaorg || (ClaimsOrganizationSchemaorg = {}));
 export var ClaimsOfferSchemaorg;
@@ -100,6 +114,10 @@ export var ClaimsOfferSchemaorg;
     ClaimsOfferSchemaorg["priceCurrency"] = "org.schema.Offer.priceCurrency";
     ClaimsOfferSchemaorg["serialNumber"] = "org.schema.Offer.serialNumber";
 })(ClaimsOfferSchemaorg || (ClaimsOfferSchemaorg = {}));
+export var ClaimsOrderSchemaorg;
+(function (ClaimsOrderSchemaorg) {
+    ClaimsOrderSchemaorg["orderedItemServiceType"] = "org.schema.Order.orderedItem.serviceType";
+})(ClaimsOrderSchemaorg || (ClaimsOrderSchemaorg = {}));
 /** For Employees (and Employee Role, but no PII) and customers / related persons.
  * - `givenName`: The given name of the person.
  * - `familyName`: The primary family name or surname of the person.

package/dist/constants/service-capabilities.d.ts

@@ -92,6 +92,10 @@ export declare function normalizeServiceCapability(value: string | undefined | n
  * Parses the CSV stored in `org.schema.Service.serviceType`.
  */
 export declare function parseServiceCapabilityTokens(value: unknown): string[];
+/**
+ * Merges capability claims published across compatibility locations.
+ */
+export declare function mergeServiceCapabilityClaims(...values: unknown[]): string | undefined;
 /**
  * Serializes capability tokens into the canonical CSV claim format.
  */

package/dist/constants/service-capabilities.js

@@ -117,6 +117,13 @@ export function parseServiceCapabilityTokens(value) {
         .map((item) => normalizeServiceCapability(item))
         .filter((item) => Boolean(item))));
 }
+/**
+ * Merges capability claims published across compatibility locations.
+ */
+export function mergeServiceCapabilityClaims(...values) {
+    const merged = Array.from(new Set(values.flatMap((value) => parseServiceCapabilityTokens(value))));
+    return merged.length ? merged.join(',') : undefined;
+}
 /**
  * Serializes capability tokens into the canonical CSV claim format.
  */

package/dist/examples/shared.d.ts

@@ -1,3 +1,5 @@
+import { BirthSex, GenderIdentity } from '../constants/identity-gender';
+import { IdKind } from '../constants/identity-identifiers';
 /**
  * Shared low-level example fragments reused by multiple flow-specific example modules.
  *
@@ -16,6 +18,67 @@ export declare const EXAMPLE_ROUTE_VERSION: "v1";
 export declare const EXAMPLE_SECTOR: "health-care";
 export declare const EXAMPLE_EMAIL_CONTROLLER_ORG: "controller@acme.org";
 export declare const EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL: "ana.parent@example.org";
+export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_ALTERNATE_NAME: "Jane";
+export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL: "Jane.Doe@example.com";
+export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL_NORMALIZED: "jane.doe@example.com";
+export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_GENDER = BirthSex.Female;
+export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_BIRTH_YEAR: "1980";
+export declare const EXAMPLE_REGISTERED_SUBJECT_ALTERNATE_NAME: "Doraemon";
+export declare const EXAMPLE_REGISTERED_SUBJECT_BIRTH_YEAR: "2020";
+export declare const EXAMPLE_PDF_CONSENT_DATE: "2026-06-08";
+/**
+ * Public provider domain selected during autodiscovery.
+ *
+ * This value may be:
+ * - a public domain masking the hosted tenant path, e.g. `service.provider.example`
+ * - or a hosted `did:web` base path without scheme, e.g.
+ *   `hosting.example.com/acme-id/cds-es/v1/health-care`
+ *
+ * The outbox later resolves the DID document from this base and derives the
+ * concrete endpoint URL for the selected operation.
+ */
+export declare const EXAMPLE_SERVICE_PROVIDER_DOMAIN: "service.provider.example";
+/** Example hosted `did:web` base without scheme, useful for tests/docs. */
+export declare const EXAMPLE_SERVICE_PROVIDER_HOSTED_DID_WEB_BASE: "hosting.example.com/acme-id/cds-es/v1/health-care";
+/** @deprecated Use `EXAMPLE_SERVICE_PROVIDER_DOMAIN`. */
+export declare const EXAMPLE_PDF_SERVICE_PROVIDER_DOMAIN: "service.provider.example";
+export declare const EXAMPLE_KYC_CONTROLLER_UUID: "033ceb35-2528-402e-8385-f22e12f57805";
+export declare const EXAMPLE_KYC_CONTROLLER_USER_UUID: "8c18ec13-e908-4b7a-91bb-134bb3a229e1";
+export declare const EXAMPLE_KYC_CONTROLLER_GIVEN_NAME: "System";
+export declare const EXAMPLE_KYC_CONTROLLER_FAMILY_NAME: "User";
+export declare const EXAMPLE_KYC_CONTROLLER_COUNTRY: "VE";
+export declare const EXAMPLE_KYC_CONTROLLER_CITY: "Caracas";
+export declare const EXAMPLE_KYC_CONTROLLER_STREET_ADDRESS: "Av. Principal 123";
+export declare const EXAMPLE_KYC_CONTROLLER_IDENTIFIER: "V-12345678";
+export declare const EXAMPLE_KYC_CONTROLLER_POSTAL_CODE: "1010";
+export declare const EXAMPLE_KYC_CONTROLLER_TELEPHONE: "+58-424-555-1234";
+export declare const EXAMPLE_KYC_CONTROLLER_BIRTHDATE: "1990-01-01";
+export declare const EXAMPLE_KYC_CONTROLLER_VERIFIED_AT: "2026-05-14T23:43:05.869+00:00";
+export declare const EXAMPLE_KYC_CONTROLLER_LANGUAGE: "es";
+export declare const EXAMPLE_KYC_CONTROLLER_CREATED_AT: "2026-05-14T23:43:05.913+00:00";
+export declare const EXAMPLE_KYC_CONTROLLER_UPDATED_AT: "2026-05-14T23:43:05.913+00:00";
+export declare const EXAMPLE_KYC_CONTROLLER_GENDER_MALE = BirthSex.Male;
+export declare const EXAMPLE_KYC_CONTROLLER_GENDER_FEMALE = BirthSex.Female;
+export declare const EXAMPLE_KYC_CONTROLLER_GENDER_IDENTITY_MAN = GenderIdentity.Man;
+export declare const EXAMPLE_KYC_CONTROLLER_GENDER_IDENTITY_WOMAN = GenderIdentity.Woman;
+export declare const EXAMPLE_CONTROLLER_IDENTIFIER_TYPE = IdKind.PersonalNationalNumber;
+export declare const EXAMPLE_SUBJECT_IDENTIFIER_TYPE = IdKind.LocalPatientIdentifier;
+export declare const EXAMPLE_SYNTHETIC_SIGNER_SUBJECT_DN: "CN=DOE JANE - TEST1234,SN=DOE,GN=JANE,serialNumber=IDCES-TEST1234,C=ES";
+export declare const EXAMPLE_SYNTHETIC_CERT_COMMON_NAME: "DOE JANE - TEST1234";
+export declare const EXAMPLE_SYNTHETIC_CERT_FAMILY_NAME: "DOE";
+export declare const EXAMPLE_SYNTHETIC_CERT_GIVEN_NAME: "JANE";
+export declare const EXAMPLE_SYNTHETIC_CERT_SERIAL_NUMBER: "IDCES-TEST1234";
+export declare const EXAMPLE_SYNTHETIC_CERT_COUNTRY: "ES";
+export declare const EXAMPLE_SYNTHETIC_CERT_DISPLAY_NAME: "JANE DOE";
+export declare const EXAMPLE_KYC_CONTROLLER_DISPLAY_NAME: "SYSTEM USER";
+export declare const EXAMPLE_FORM_CONTROLLER_PHONE: "+34000000001";
+export declare const EXAMPLE_FORM_SUBJECT_PHONE: "+34000000002";
+export declare const EXAMPLE_FORM_CONTROLLER_IDENTIFIER_VALUE: "identifier-controller-001";
+export declare const EXAMPLE_FORM_SUBJECT_IDENTIFIER_VALUE: "identifier-subject-001";
+export declare const EXAMPLE_OTP_INVITATION_ID: "invitation-demo-001";
+export declare const EXAMPLE_OTP_CHALLENGE_ID: "otp-challenge-demo-001";
+export declare const EXAMPLE_OTP_CODE: "123456";
+export declare const EXAMPLE_DEMO_PORTAL_ID_TOKEN: "eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0.eyJzdWIiOiJkZW1vLXVzZXIiLCJlbWFpbCI6ImRlbW9AZXhhbXBsZS5vcmcifQ.demo";
 export declare const EXAMPLE_TENANT_ROUTE_CONTEXT: {
     readonly tenantId: "acme-id";
     readonly jurisdiction: "ES";
@@ -101,6 +164,13 @@ export declare const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF: "application/p
 export declare const EXAMPLE_DOCUMENT_REFERENCE_URL: "https://example.org/prescription.pdf";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION: "Prescription PDF";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_DATE: "2026-06-12T10:00:00Z";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_HASH: "z-document-reference-example-hash";
+export declare const EXAMPLE_DOCUMENT_REFERENCE_LANGUAGE: "en";
+export declare const EXAMPLE_CONSENT_ATTACHMENT_CONTENT_TYPE: "application/pdf";
+export declare const EXAMPLE_CONSENT_ATTACHMENT_DATA_BASE64: "JVBERi0xLjQKJUZha2UgY29uc2VudCBQREYgZm9yIGxvY2FsIHNtb2tlIHRlc3QK";
+export declare const EXAMPLE_CONTENT_ADDRESSED_CONSENT_IDENTIFIER: "zQmYwAPJzv5CZsnAzt8auVZRnGi2C31WnH8D9N6A7h7vY2";
+export declare const EXAMPLE_CONTENT_ADDRESSED_SOURCE_REFERENCE: "zQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWv";
+export declare const EXAMPLE_CONTENT_ADDRESSED_EVIDENCE_RECORD_IDENTIFIER: "zQmXh8Y3mJQ4d7MmX7o9nP5sQ2uT1vW6xY8zA3bC4dE5fG";
 export declare const EXAMPLE_EMPLOYEE_ACTIVATION_CODE: "ACT-001";
 export declare const EXAMPLE_DEVICE_CLIENT_ID: "did:web:device-001";
 export declare const EXAMPLE_LIVE_GW_BASE_URL_LOCAL: "http://127.0.0.1:3000";

package/dist/examples/shared.js

@@ -2,6 +2,8 @@
 // Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
 import { DataspaceSectors } from '../constants/sectors.js';
 import { HostNetworkTypes } from '../constants/network.js';
+import { BirthSex, GenderIdentity } from '../constants/identity-gender.js';
+import { IdKind } from '../constants/identity-identifiers.js';
 import { HealthcareActorRoles, HealthcareBasicSections, HealthcareConsentPurposes, } from '../constants/healthcare.js';
 import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
 import { MedicationStatementClaim, MedicationStatementClaimsFhirApiExtended, } from '../models/interoperable-claims/medication-statement-claims.js';
@@ -24,6 +26,67 @@ export const EXAMPLE_ROUTE_VERSION = 'v1';
 export const EXAMPLE_SECTOR = DataspaceSectors.HealthCare;
 export const EXAMPLE_EMAIL_CONTROLLER_ORG = 'controller@acme.org';
 export const EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL = 'ana.parent@example.org';
+export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_ALTERNATE_NAME = 'Jane';
+export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL = 'Jane.Doe@example.com';
+export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL_NORMALIZED = 'jane.doe@example.com';
+export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_GENDER = BirthSex.Female;
+export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_BIRTH_YEAR = '1980';
+export const EXAMPLE_REGISTERED_SUBJECT_ALTERNATE_NAME = 'Doraemon';
+export const EXAMPLE_REGISTERED_SUBJECT_BIRTH_YEAR = '2020';
+export const EXAMPLE_PDF_CONSENT_DATE = '2026-06-08';
+/**
+ * Public provider domain selected during autodiscovery.
+ *
+ * This value may be:
+ * - a public domain masking the hosted tenant path, e.g. `service.provider.example`
+ * - or a hosted `did:web` base path without scheme, e.g.
+ *   `hosting.example.com/acme-id/cds-es/v1/health-care`
+ *
+ * The outbox later resolves the DID document from this base and derives the
+ * concrete endpoint URL for the selected operation.
+ */
+export const EXAMPLE_SERVICE_PROVIDER_DOMAIN = 'service.provider.example';
+/** Example hosted `did:web` base without scheme, useful for tests/docs. */
+export const EXAMPLE_SERVICE_PROVIDER_HOSTED_DID_WEB_BASE = 'hosting.example.com/acme-id/cds-es/v1/health-care';
+/** @deprecated Use `EXAMPLE_SERVICE_PROVIDER_DOMAIN`. */
+export const EXAMPLE_PDF_SERVICE_PROVIDER_DOMAIN = EXAMPLE_SERVICE_PROVIDER_DOMAIN;
+export const EXAMPLE_KYC_CONTROLLER_UUID = '033ceb35-2528-402e-8385-f22e12f57805';
+export const EXAMPLE_KYC_CONTROLLER_USER_UUID = '8c18ec13-e908-4b7a-91bb-134bb3a229e1';
+export const EXAMPLE_KYC_CONTROLLER_GIVEN_NAME = 'System';
+export const EXAMPLE_KYC_CONTROLLER_FAMILY_NAME = 'User';
+export const EXAMPLE_KYC_CONTROLLER_COUNTRY = 'VE';
+export const EXAMPLE_KYC_CONTROLLER_CITY = 'Caracas';
+export const EXAMPLE_KYC_CONTROLLER_STREET_ADDRESS = 'Av. Principal 123';
+export const EXAMPLE_KYC_CONTROLLER_IDENTIFIER = 'V-12345678';
+export const EXAMPLE_KYC_CONTROLLER_POSTAL_CODE = '1010';
+export const EXAMPLE_KYC_CONTROLLER_TELEPHONE = '+58-424-555-1234';
+export const EXAMPLE_KYC_CONTROLLER_BIRTHDATE = '1990-01-01';
+export const EXAMPLE_KYC_CONTROLLER_VERIFIED_AT = '2026-05-14T23:43:05.869+00:00';
+export const EXAMPLE_KYC_CONTROLLER_LANGUAGE = 'es';
+export const EXAMPLE_KYC_CONTROLLER_CREATED_AT = '2026-05-14T23:43:05.913+00:00';
+export const EXAMPLE_KYC_CONTROLLER_UPDATED_AT = '2026-05-14T23:43:05.913+00:00';
+export const EXAMPLE_KYC_CONTROLLER_GENDER_MALE = BirthSex.Male;
+export const EXAMPLE_KYC_CONTROLLER_GENDER_FEMALE = BirthSex.Female;
+export const EXAMPLE_KYC_CONTROLLER_GENDER_IDENTITY_MAN = GenderIdentity.Man;
+export const EXAMPLE_KYC_CONTROLLER_GENDER_IDENTITY_WOMAN = GenderIdentity.Woman;
+export const EXAMPLE_CONTROLLER_IDENTIFIER_TYPE = IdKind.PersonalNationalNumber;
+export const EXAMPLE_SUBJECT_IDENTIFIER_TYPE = IdKind.LocalPatientIdentifier;
+export const EXAMPLE_SYNTHETIC_SIGNER_SUBJECT_DN = 'CN=DOE JANE - TEST1234,SN=DOE,GN=JANE,serialNumber=IDCES-TEST1234,C=ES';
+export const EXAMPLE_SYNTHETIC_CERT_COMMON_NAME = 'DOE JANE - TEST1234';
+export const EXAMPLE_SYNTHETIC_CERT_FAMILY_NAME = 'DOE';
+export const EXAMPLE_SYNTHETIC_CERT_GIVEN_NAME = 'JANE';
+export const EXAMPLE_SYNTHETIC_CERT_SERIAL_NUMBER = 'IDCES-TEST1234';
+export const EXAMPLE_SYNTHETIC_CERT_COUNTRY = 'ES';
+export const EXAMPLE_SYNTHETIC_CERT_DISPLAY_NAME = 'JANE DOE';
+export const EXAMPLE_KYC_CONTROLLER_DISPLAY_NAME = 'SYSTEM USER';
+export const EXAMPLE_FORM_CONTROLLER_PHONE = '+34000000001';
+export const EXAMPLE_FORM_SUBJECT_PHONE = '+34000000002';
+export const EXAMPLE_FORM_CONTROLLER_IDENTIFIER_VALUE = 'identifier-controller-001';
+export const EXAMPLE_FORM_SUBJECT_IDENTIFIER_VALUE = 'identifier-subject-001';
+export const EXAMPLE_OTP_INVITATION_ID = 'invitation-demo-001';
+export const EXAMPLE_OTP_CHALLENGE_ID = 'otp-challenge-demo-001';
+export const EXAMPLE_OTP_CODE = '123456';
+export const EXAMPLE_DEMO_PORTAL_ID_TOKEN = 'eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0.eyJzdWIiOiJkZW1vLXVzZXIiLCJlbWFpbCI6ImRlbW9AZXhhbXBsZS5vcmcifQ.demo';
 export const EXAMPLE_TENANT_ROUTE_CONTEXT = {
     tenantId: EXAMPLE_TENANT_IDENTIFIER,
     jurisdiction: EXAMPLE_JURISDICTION,
@@ -109,6 +172,13 @@ export const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF = 'application/pdf';
 export const EXAMPLE_DOCUMENT_REFERENCE_URL = 'https://example.org/prescription.pdf';
 export const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION = 'Prescription PDF';
 export const EXAMPLE_DOCUMENT_REFERENCE_DATE = '2026-06-12T10:00:00Z';
+export const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_HASH = 'z-document-reference-example-hash';
+export const EXAMPLE_DOCUMENT_REFERENCE_LANGUAGE = 'en';
+export const EXAMPLE_CONSENT_ATTACHMENT_CONTENT_TYPE = EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF;
+export const EXAMPLE_CONSENT_ATTACHMENT_DATA_BASE64 = 'JVBERi0xLjQKJUZha2UgY29uc2VudCBQREYgZm9yIGxvY2FsIHNtb2tlIHRlc3QK';
+export const EXAMPLE_CONTENT_ADDRESSED_CONSENT_IDENTIFIER = 'zQmYwAPJzv5CZsnAzt8auVZRnGi2C31WnH8D9N6A7h7vY2';
+export const EXAMPLE_CONTENT_ADDRESSED_SOURCE_REFERENCE = 'zQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWv';
+export const EXAMPLE_CONTENT_ADDRESSED_EVIDENCE_RECORD_IDENTIFIER = 'zQmXh8Y3mJQ4d7MmX7o9nP5sQ2uT1vW6xY8zA3bC4dE5fG';
 export const EXAMPLE_EMPLOYEE_ACTIVATION_CODE = 'ACT-001';
 export const EXAMPLE_DEVICE_CLIENT_ID = 'did:web:device-001';
 export const EXAMPLE_LIVE_GW_BASE_URL_LOCAL = 'http://127.0.0.1:3000';

package/dist/models/consent-rule.d.ts

@@ -14,6 +14,8 @@ export declare enum ClaimConsent {
     'verifiedDate' = "Consent.verified-date",
     'purpose' = "Consent.purpose",
     'identifier' = "Consent.identifier",
+    'eventBasedOn' = "Consent.event-basedon",
+    'sourceReference' = "Consent.source-reference",
     'containedDocuments' = "Consent.contained-documents",
     /**
      * @deprecated Use `containedDocuments`.

package/dist/models/consent-rule.js

@@ -16,6 +16,8 @@ export var ClaimConsent;
     ClaimConsent["verifiedDate"] = "Consent.verified-date";
     ClaimConsent["purpose"] = "Consent.purpose";
     ClaimConsent["identifier"] = "Consent.identifier";
+    ClaimConsent["eventBasedOn"] = "Consent.event-basedon";
+    ClaimConsent["sourceReference"] = "Consent.source-reference";
     ClaimConsent["containedDocuments"] = "Consent.contained-documents";
     /**
      * @deprecated Use `containedDocuments`.

package/dist/models/index.d.ts

@@ -21,6 +21,7 @@ export * from './fhir-documents';
 export * from './interoperable-claims';
 export * from './indexing';
 export * from './identity-bootstrap';
+export * from './individual-onboarding';
 export * from './issue';
 export * from './jsonapi';
 export * from './jwe';

package/dist/models/index.js

@@ -21,6 +21,7 @@ export * from './fhir-documents.js';
 export * from './interoperable-claims.js';
 export * from './indexing.js';
 export * from './identity-bootstrap.js';
+export * from './individual-onboarding.js';
 export * from './issue.js';
 export * from './jsonapi.js';
 export * from './jwe.js';