gdc-common-utils-ts 1.20.2 → 1.23.0

package/dist/examples/lifecycle.d.ts

@@ -10,6 +10,8 @@ export declare const EXAMPLE_LIFECYCLE_OPERATIONS: {
     readonly disable: "disable";
     readonly delete: "delete";
 };
+export declare const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_REQUEST_TYPE: "Family-disable-request-v1.0";
+export declare const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_REQUEST_TYPE: "Family-purge-request-v1.0";
 /**
  * Shared placeholder values used by copy/paste examples.
  *
@@ -179,6 +181,27 @@ export declare const EXAMPLE_INDIVIDUAL_DISABLE_MESSAGE: {
         readonly erasesPersonalDataImmediately: false;
     };
 };
+export declare const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_ENTRY: Readonly<{
+    type: string;
+    request: {
+        method: "POST";
+    };
+    meta: {
+        claims: import("..").IndividualOrganizationLifecycleClaims;
+    };
+    resource: {
+        id?: string;
+        meta: {
+            claims: import("..").IndividualOrganizationLifecycleClaims;
+        };
+    };
+}>;
+export declare const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_PAYLOAD: Readonly<{
+    thid: string;
+    body: {
+        data: import("..").IndividualOrganizationLifecycleDataEntry[];
+    };
+}>;
 export declare const EXAMPLE_INDIVIDUAL_DELETE_MESSAGE: {
     readonly operation: "delete";
     readonly resourceType: "IndividualOrganization";
@@ -199,6 +222,27 @@ export declare const EXAMPLE_INDIVIDUAL_DELETE_MESSAGE: {
         readonly keepsMinimumAuditTrailRequiredByLaw: true;
     };
 };
+export declare const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_ENTRY: Readonly<{
+    type: string;
+    request: {
+        method: "POST";
+    };
+    meta: {
+        claims: import("..").IndividualOrganizationLifecycleClaims;
+    };
+    resource: {
+        id?: string;
+        meta: {
+            claims: import("..").IndividualOrganizationLifecycleClaims;
+        };
+    };
+}>;
+export declare const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_PAYLOAD: Readonly<{
+    thid: string;
+    body: {
+        data: import("..").IndividualOrganizationLifecycleDataEntry[];
+    };
+}>;
 export declare const EXAMPLE_CONSENT_ENABLE_MESSAGE: {
     readonly operation: "enable";
     readonly resourceType: "Consent";

package/dist/examples/lifecycle.js

@@ -1,6 +1,7 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
 import { ClaimsOrganizationSchemaorg, ClaimsPersonSchemaorg, } from '../constants/schemaorg.js';
 import { ClaimConsent } from '../models/consent-rule.js';
+import { IndividualOrganizationLifecycleDraft, IndividualOrganizationLifecycleOperations, } from '../utils/individual-organization-lifecycle.js';
 import { EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL, EXAMPLE_EMAIL_CONTROLLER_ORG, EXAMPLE_CLINICAL_SECTION_ALLERGIES, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_JURISDICTION, EXAMPLE_SECTOR, EXAMPLE_TENANT_IDENTIFIER, } from './shared.js';
 /**
  * Canonical lifecycle naming for `v1`.
@@ -14,6 +15,8 @@ export const EXAMPLE_LIFECYCLE_OPERATIONS = {
     disable: 'disable',
     delete: 'delete',
 };
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_REQUEST_TYPE = 'Family-disable-request-v1.0';
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_REQUEST_TYPE = 'Family-purge-request-v1.0';
 /**
  * Shared placeholder values used by copy/paste examples.
  *
@@ -183,6 +186,17 @@ export const EXAMPLE_INDIVIDUAL_DISABLE_MESSAGE = {
         erasesPersonalDataImmediately: false,
     },
 };
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_ENTRY = new IndividualOrganizationLifecycleDraft()
+    .setClaims(EXAMPLE_INDIVIDUAL_DISABLE_MESSAGE.claims)
+    .setOperation(IndividualOrganizationLifecycleOperations.Disable)
+    .setRequestType(EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_REQUEST_TYPE)
+    .buildCurrentGwDataEntry();
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_PAYLOAD = new IndividualOrganizationLifecycleDraft()
+    .setClaims(EXAMPLE_INDIVIDUAL_DISABLE_MESSAGE.claims)
+    .setOperation(IndividualOrganizationLifecycleOperations.Disable)
+    .setRequestType(EXAMPLE_INDIVIDUAL_ORGANIZATION_DISABLE_REQUEST_TYPE)
+    .setThreadId('individual-organization-disable-example-001')
+    .buildCurrentGwPayload();
 export const EXAMPLE_INDIVIDUAL_DELETE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.delete,
     resourceType: 'IndividualOrganization',
@@ -203,6 +217,17 @@ export const EXAMPLE_INDIVIDUAL_DELETE_MESSAGE = {
         keepsMinimumAuditTrailRequiredByLaw: true,
     },
 };
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_ENTRY = new IndividualOrganizationLifecycleDraft()
+    .setClaims(EXAMPLE_INDIVIDUAL_DISABLE_MESSAGE.claims)
+    .setOperation(IndividualOrganizationLifecycleOperations.Purge)
+    .setRequestType(EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_REQUEST_TYPE)
+    .buildCurrentGwDataEntry();
+export const EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_PAYLOAD = new IndividualOrganizationLifecycleDraft()
+    .setClaims(EXAMPLE_INDIVIDUAL_DISABLE_MESSAGE.claims)
+    .setOperation(IndividualOrganizationLifecycleOperations.Purge)
+    .setRequestType(EXAMPLE_INDIVIDUAL_ORGANIZATION_PURGE_REQUEST_TYPE)
+    .setThreadId('individual-organization-purge-example-001')
+    .buildCurrentGwPayload();
 export const EXAMPLE_CONSENT_ENABLE_MESSAGE = {
     operation: EXAMPLE_LIFECYCLE_OPERATIONS.enable,
     resourceType: 'Consent',

package/dist/examples/related-person.d.ts

@@ -1,10 +1,358 @@
 /**
  * Examples for related-person / family-member flows.
  */
+export declare const EXAMPLE_RELATED_PERSON_RESOURCE_TYPE: "RelatedPerson";
+export declare const EXAMPLE_RELATED_PERSON_DISABLE_REQUEST_TYPE: "RelatedPerson-disable-request-v1.0";
+export declare const EXAMPLE_RELATED_PERSON_PURGE_REQUEST_TYPE: "RelatedPerson-purge-request-v1.0";
+export declare const EXAMPLE_RELATED_PERSON_INTERNAL_RESOURCE_ID: "related-person-internal-001";
+export declare const EXAMPLE_RELATED_PERSON_SEARCH_URL: string;
+export declare const EXAMPLE_RELATED_PERSON_DISPLAY_NAME: "Jose Example";
+/**
+ * Minimal semantic input used by SDK helpers to disable one subject-side
+ * relationship record through the identifier-first lifecycle contract.
+ */
+export declare const EXAMPLE_RELATED_PERSON_DISABLE_INPUT: {
+    readonly memberClaims: {
+        readonly '@context': "org.hl7.fhir.api";
+        readonly "RelatedPerson.identifier": "rel-001";
+        readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+        readonly "RelatedPerson.telecom": "mailto:parent.guardian@example.org";
+        readonly "RelatedPerson.relationship": "v3-RoleCode|RESPRSN";
+    };
+    readonly resourceId: "rel-001";
+};
+/**
+ * Canonical lifecycle resource emitted by the shared identifier-first disable
+ * contract after the FHIR/business identifier has been normalized.
+ */
+export declare const EXAMPLE_RELATED_PERSON_DISABLE_LIFECYCLE_RESOURCE: {
+    resourceType: string;
+    id?: string;
+    identifier?: Array<{
+        value: string;
+        system?: string;
+    }>;
+    meta: {
+        claims: Record<string, unknown>;
+        status?: import("..").InteroperableLifecycleStatus;
+    };
+};
+/**
+ * Shared operational bundle entry for `disableIndividualMember(...)`.
+ *
+ * Downstream SDK tests can assert against this fixture directly instead of
+ * rebuilding the lifecycle resource shape inline.
+ */
+export declare const EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_ENTRY: {
+    readonly request: {
+        readonly method: "POST";
+    };
+    readonly meta: {
+        readonly claims: {
+            readonly '@context': "org.hl7.fhir.api";
+            readonly "RelatedPerson.identifier": "rel-001";
+            readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+            readonly "RelatedPerson.telecom": "mailto:parent.guardian@example.org";
+            readonly "RelatedPerson.relationship": "v3-RoleCode|RESPRSN";
+        };
+    };
+    readonly resource: {
+        readonly id: "rel-001";
+        readonly resourceType: string;
+        readonly identifier?: Array<{
+            value: string;
+            system?: string;
+        }>;
+        readonly meta: {
+            claims: Record<string, unknown>;
+            status?: import("..").InteroperableLifecycleStatus;
+        };
+    };
+};
+/**
+ * Full shared disable payload used by runtime/documentation examples.
+ */
+export declare const EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_PAYLOAD: {
+    readonly thid: "relatedperson-disable-example-001";
+    readonly body: {
+        readonly resourceType: "Bundle";
+        readonly type: "batch";
+        readonly entry: readonly [{
+            readonly request: {
+                readonly method: "POST";
+            };
+            readonly meta: {
+                readonly claims: {
+                    readonly '@context': "org.hl7.fhir.api";
+                    readonly "RelatedPerson.identifier": "rel-001";
+                    readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+                    readonly "RelatedPerson.telecom": "mailto:parent.guardian@example.org";
+                    readonly "RelatedPerson.relationship": "v3-RoleCode|RESPRSN";
+                };
+            };
+            readonly resource: {
+                readonly id: "rel-001";
+                readonly resourceType: string;
+                readonly identifier?: Array<{
+                    value: string;
+                    system?: string;
+                }>;
+                readonly meta: {
+                    claims: Record<string, unknown>;
+                    status?: import("..").InteroperableLifecycleStatus;
+                };
+            };
+        }];
+    };
+};
+export declare const EXAMPLE_RELATED_PERSON_PURGE_LIFECYCLE_RESOURCE: {
+    resourceType: string;
+    id?: string;
+    identifier?: Array<{
+        value: string;
+        system?: string;
+    }>;
+    meta: {
+        claims: Record<string, unknown>;
+        status?: import("..").InteroperableLifecycleStatus;
+    };
+};
+export declare const EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_ENTRY: {
+    readonly type: "RelatedPerson-purge-request-v1.0";
+    readonly request: {
+        readonly method: "POST";
+    };
+    readonly meta: {
+        readonly claims: {
+            readonly '@context': "org.hl7.fhir.api";
+            readonly "RelatedPerson.identifier": "rel-001";
+            readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+            readonly "RelatedPerson.telecom": "mailto:parent.guardian@example.org";
+            readonly "RelatedPerson.relationship": "v3-RoleCode|RESPRSN";
+        };
+    };
+    readonly resource: {
+        readonly id: "rel-001";
+        readonly resourceType: string;
+        readonly identifier?: Array<{
+            value: string;
+            system?: string;
+        }>;
+        readonly meta: {
+            claims: Record<string, unknown>;
+            status?: import("..").InteroperableLifecycleStatus;
+        };
+    };
+};
+export declare const EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_PAYLOAD: {
+    readonly thid: "relatedperson-purge-example-001";
+    readonly body: {
+        readonly resourceType: "Bundle";
+        readonly type: "batch";
+        readonly entry: readonly [{
+            readonly type: "RelatedPerson-purge-request-v1.0";
+            readonly request: {
+                readonly method: "POST";
+            };
+            readonly meta: {
+                readonly claims: {
+                    readonly '@context': "org.hl7.fhir.api";
+                    readonly "RelatedPerson.identifier": "rel-001";
+                    readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+                    readonly "RelatedPerson.telecom": "mailto:parent.guardian@example.org";
+                    readonly "RelatedPerson.relationship": "v3-RoleCode|RESPRSN";
+                };
+            };
+            readonly resource: {
+                readonly id: "rel-001";
+                readonly resourceType: string;
+                readonly identifier?: Array<{
+                    value: string;
+                    system?: string;
+                }>;
+                readonly meta: {
+                    claims: Record<string, unknown>;
+                    status?: import("..").InteroperableLifecycleStatus;
+                };
+            };
+        }];
+    };
+};
+/**
+ * Canonical upsert payload for subject-side relationship examples.
+ *
+ * This bundle shape is the shared SDK/documentation fixture and should be
+ * reused by downstream repositories instead of rebuilding inline `Bundle`
+ * examples for `upsertRelatedPersonAndPoll(...)`.
+ */
+export declare const EXAMPLE_RELATED_PERSON_UPSERT_BUNDLE_PAYLOAD: {
+    readonly thid: "relatedperson-upsert-example-001";
+    readonly body: {
+        readonly resourceType: "Bundle";
+        readonly type: "batch";
+        readonly entry: readonly [{
+            readonly resource: {
+                readonly resourceType: "RelatedPerson";
+                readonly id: "grandfather-001";
+                readonly patient: {
+                    readonly reference: "did:web:api.acme.org:individual:123";
+                };
+                readonly relationship: readonly [{
+                    readonly text: "Grandfather";
+                }];
+                readonly name: readonly [{
+                    readonly text: "Jose Example";
+                }];
+            };
+        }];
+    };
+};
+/** @deprecated Use `EXAMPLE_RELATED_PERSON_UPSERT_BUNDLE_PAYLOAD`. */
 export declare const EXAMPLE_RELATED_PERSON_PAYLOAD: {
+    readonly thid: "relatedperson-upsert-example-001";
+    readonly body: {
+        readonly resourceType: "Bundle";
+        readonly type: "batch";
+        readonly entry: readonly [{
+            readonly resource: {
+                readonly resourceType: "RelatedPerson";
+                readonly id: "grandfather-001";
+                readonly patient: {
+                    readonly reference: "did:web:api.acme.org:individual:123";
+                };
+                readonly relationship: readonly [{
+                    readonly text: "Grandfather";
+                }];
+                readonly name: readonly [{
+                    readonly text: "Jose Example";
+                }];
+            };
+        }];
+    };
+};
+/**
+ * Legacy JSON:API-style shell still referenced by older pass-through tests.
+ */
+export declare const EXAMPLE_RELATED_PERSON_BATCH_DATA_PAYLOAD: {
     readonly body: {
         readonly data: readonly [{
             readonly type: "RelatedPerson";
         }];
     };
 };
+/**
+ * FHIR-shaped example used to demonstrate identifier-first operational
+ * normalization before claims-first processing.
+ */
+export declare const EXAMPLE_RELATED_PERSON_FHIR_RESOURCE: {
+    readonly resourceType: "RelatedPerson";
+    readonly id: "related-person-internal-001";
+    readonly identifier: readonly [{
+        readonly value: "rel-001";
+    }];
+    readonly active: true;
+    readonly patient: {
+        readonly reference: "did:web:api.acme.org:individual:123";
+    };
+    readonly relationship: readonly [{
+        readonly coding: readonly [{
+            readonly code: string;
+            readonly system: "http://terminology.hl7.org/CodeSystem/v3-RoleCode";
+        }];
+    }];
+    readonly telecom: readonly [{
+        readonly value: "mailto:parent.guardian@example.org";
+    }];
+};
+export declare const EXAMPLE_RELATED_PERSON_DISABLE_SEARCH_PARAMS: {
+    readonly identifier: "rel-001";
+};
+export declare const EXAMPLE_RELATED_PERSON_LIST_RECORD_ACTIVE: {
+    readonly id: "related-person-internal-001";
+    readonly meta: {
+        readonly status: "active";
+    };
+    readonly resource: {
+        readonly resourceType: "RelatedPerson";
+        readonly id: "related-person-internal-001";
+        readonly meta: {
+            readonly claims: {
+                readonly '@context': "org.hl7.fhir.api";
+                readonly "RelatedPerson.identifier": "rel-001";
+                readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+                readonly "RelatedPerson.telecom": "mailto:parent.guardian@example.org";
+                readonly "RelatedPerson.relationship": "v3-RoleCode|RESPRSN";
+                readonly "RelatedPerson.name": "Jose Example";
+                readonly "RelatedPerson.active": "true";
+            };
+        };
+    };
+};
+export declare const EXAMPLE_RELATED_PERSON_LIST_RECORD_INACTIVE: {
+    readonly id: "related-person-internal-002";
+    readonly meta: {
+        readonly status: "inactive";
+    };
+    readonly resource: {
+        readonly resourceType: "RelatedPerson";
+        readonly id: "related-person-internal-002";
+        readonly meta: {
+            readonly claims: {
+                readonly '@context': "org.hl7.fhir.api";
+                readonly "RelatedPerson.identifier": "urn:uuid:related-person-002";
+                readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+                readonly "RelatedPerson.telecom": "mailto:caregiver.two@example.org";
+                readonly "RelatedPerson.relationship": "http://terminology.hl7.org/CodeSystem/v3-RoleCode|NMTH";
+                readonly "RelatedPerson.name": "Maria Example";
+                readonly "RelatedPerson.active": "false";
+            };
+        };
+    };
+};
+export declare const EXAMPLE_RELATED_PERSON_LIST_RESPONSE_BODY: {
+    readonly body: {
+        readonly data: readonly [{
+            readonly id: "related-person-internal-001";
+            readonly meta: {
+                readonly status: "active";
+            };
+            readonly resource: {
+                readonly resourceType: "RelatedPerson";
+                readonly id: "related-person-internal-001";
+                readonly meta: {
+                    readonly claims: {
+                        readonly '@context': "org.hl7.fhir.api";
+                        readonly "RelatedPerson.identifier": "rel-001";
+                        readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+                        readonly "RelatedPerson.telecom": "mailto:parent.guardian@example.org";
+                        readonly "RelatedPerson.relationship": "v3-RoleCode|RESPRSN";
+                        readonly "RelatedPerson.name": "Jose Example";
+                        readonly "RelatedPerson.active": "true";
+                    };
+                };
+            };
+        }, {
+            readonly id: "related-person-internal-002";
+            readonly meta: {
+                readonly status: "inactive";
+            };
+            readonly resource: {
+                readonly resourceType: "RelatedPerson";
+                readonly id: "related-person-internal-002";
+                readonly meta: {
+                    readonly claims: {
+                        readonly '@context': "org.hl7.fhir.api";
+                        readonly "RelatedPerson.identifier": "urn:uuid:related-person-002";
+                        readonly "RelatedPerson.patient": "did:web:api.acme.org:individual:123";
+                        readonly "RelatedPerson.telecom": "mailto:caregiver.two@example.org";
+                        readonly "RelatedPerson.relationship": "http://terminology.hl7.org/CodeSystem/v3-RoleCode|NMTH";
+                        readonly "RelatedPerson.name": "Maria Example";
+                        readonly "RelatedPerson.active": "false";
+                    };
+                };
+            };
+        }];
+    };
+};
+export declare const EXAMPLE_RELATED_PERSON_INACTIVE_STATUS: "inactive";
+export declare const EXAMPLE_RELATED_PERSON_PURGED_STATUS: "purged";

package/dist/examples/related-person.js

@@ -1,13 +1,195 @@
 // Copyright 2026 Antifraud Services Inc. under the Apache License, Version 2.0.
+import { RelatedPersonClaim } from '../models/interoperable-claims/related-person-claims.js';
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
+import { HL7_CODING_SYSTEM_V3_ROLE_CODE } from '../constants/hl7-roles.js';
+import { EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API, EXAMPLE_EMAIL_RELATED_PERSON, EXAMPLE_RELATED_PERSON_ACTIVE_NAME, EXAMPLE_RELATED_PERSON_IDENTIFIER, EXAMPLE_RELATED_PERSON_INACTIVE_EMAIL, EXAMPLE_RELATED_PERSON_INACTIVE_IDENTIFIER, EXAMPLE_RELATED_PERSON_INACTIVE_NAME, EXAMPLE_RELATED_PERSON_INACTIVE_RELATIONSHIP, EXAMPLE_RELATED_PERSON_ROLE, EXAMPLE_SUBJECT_DID, } from './shared.js';
+import { createInteroperableResourceOperationEditor, InteroperableOperationMethods, buildInteroperableSearchPath, InteroperableLifecycleStatuses, } from '../utils/interoperable-resource-operation.js';
+import { LifecycleRequestType } from '../constants/lifecycle.js';
 /**
  * Examples for related-person / family-member flows.
  */
-export const EXAMPLE_RELATED_PERSON_PAYLOAD = {
+export const EXAMPLE_RELATED_PERSON_RESOURCE_TYPE = ResourceTypesFhirR4.RelatedPerson;
+export const EXAMPLE_RELATED_PERSON_DISABLE_REQUEST_TYPE = LifecycleRequestType.RelatedPersonDisable;
+export const EXAMPLE_RELATED_PERSON_PURGE_REQUEST_TYPE = LifecycleRequestType.RelatedPersonPurge;
+export const EXAMPLE_RELATED_PERSON_INTERNAL_RESOURCE_ID = 'related-person-internal-001';
+export const EXAMPLE_RELATED_PERSON_SEARCH_URL = buildInteroperableSearchPath(EXAMPLE_RELATED_PERSON_RESOURCE_TYPE);
+export const EXAMPLE_RELATED_PERSON_DISPLAY_NAME = EXAMPLE_RELATED_PERSON_ACTIVE_NAME;
+/**
+ * Minimal semantic input used by SDK helpers to disable one subject-side
+ * relationship record through the identifier-first lifecycle contract.
+ */
+export const EXAMPLE_RELATED_PERSON_DISABLE_INPUT = {
+    memberClaims: {
+        '@context': EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API,
+        [RelatedPersonClaim.Identifier]: EXAMPLE_RELATED_PERSON_IDENTIFIER,
+        [RelatedPersonClaim.Patient]: EXAMPLE_SUBJECT_DID,
+        [RelatedPersonClaim.Telecom]: `mailto:${EXAMPLE_EMAIL_RELATED_PERSON}`,
+        [RelatedPersonClaim.Relationship]: EXAMPLE_RELATED_PERSON_ROLE,
+    },
+    resourceId: EXAMPLE_RELATED_PERSON_IDENTIFIER,
+};
+/**
+ * Canonical lifecycle resource emitted by the shared identifier-first disable
+ * contract after the FHIR/business identifier has been normalized.
+ */
+export const EXAMPLE_RELATED_PERSON_DISABLE_LIFECYCLE_RESOURCE = createInteroperableResourceOperationEditor()
+    .setResourceType(EXAMPLE_RELATED_PERSON_RESOURCE_TYPE)
+    .setIdentifierClaimKey(RelatedPersonClaim.Identifier)
+    .setBusinessIdentifier(EXAMPLE_RELATED_PERSON_DISABLE_INPUT.memberClaims[RelatedPersonClaim.Identifier])
+    .setClaims({ ...EXAMPLE_RELATED_PERSON_DISABLE_INPUT.memberClaims })
+    .setLifecycleStatus(InteroperableLifecycleStatuses.Inactive)
+    .buildLifecycleResource();
+/**
+ * Shared operational bundle entry for `disableIndividualMember(...)`.
+ *
+ * Downstream SDK tests can assert against this fixture directly instead of
+ * rebuilding the lifecycle resource shape inline.
+ */
+export const EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_ENTRY = {
+    request: { method: InteroperableOperationMethods.Post },
+    meta: { claims: { ...EXAMPLE_RELATED_PERSON_DISABLE_INPUT.memberClaims } },
+    resource: {
+        ...EXAMPLE_RELATED_PERSON_DISABLE_LIFECYCLE_RESOURCE,
+        id: EXAMPLE_RELATED_PERSON_DISABLE_INPUT.resourceId,
+    },
+};
+/**
+ * Full shared disable payload used by runtime/documentation examples.
+ */
+export const EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_PAYLOAD = {
+    thid: 'relatedperson-disable-example-001',
+    body: {
+        resourceType: 'Bundle',
+        type: 'batch',
+        entry: [EXAMPLE_RELATED_PERSON_DISABLE_BUNDLE_ENTRY],
+    },
+};
+export const EXAMPLE_RELATED_PERSON_PURGE_LIFECYCLE_RESOURCE = createInteroperableResourceOperationEditor()
+    .setResourceType(EXAMPLE_RELATED_PERSON_RESOURCE_TYPE)
+    .setIdentifierClaimKey(RelatedPersonClaim.Identifier)
+    .setBusinessIdentifier(EXAMPLE_RELATED_PERSON_DISABLE_INPUT.memberClaims[RelatedPersonClaim.Identifier])
+    .setClaims({ ...EXAMPLE_RELATED_PERSON_DISABLE_INPUT.memberClaims })
+    .setLifecycleStatus(InteroperableLifecycleStatuses.Purged)
+    .buildLifecycleResource();
+export const EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_ENTRY = {
+    type: EXAMPLE_RELATED_PERSON_PURGE_REQUEST_TYPE,
+    request: { method: InteroperableOperationMethods.Post },
+    meta: { claims: { ...EXAMPLE_RELATED_PERSON_DISABLE_INPUT.memberClaims } },
+    resource: {
+        ...EXAMPLE_RELATED_PERSON_PURGE_LIFECYCLE_RESOURCE,
+        id: EXAMPLE_RELATED_PERSON_DISABLE_INPUT.resourceId,
+    },
+};
+export const EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_PAYLOAD = {
+    thid: 'relatedperson-purge-example-001',
+    body: {
+        resourceType: 'Bundle',
+        type: 'batch',
+        entry: [EXAMPLE_RELATED_PERSON_PURGE_BUNDLE_ENTRY],
+    },
+};
+/**
+ * Canonical upsert payload for subject-side relationship examples.
+ *
+ * This bundle shape is the shared SDK/documentation fixture and should be
+ * reused by downstream repositories instead of rebuilding inline `Bundle`
+ * examples for `upsertRelatedPersonAndPoll(...)`.
+ */
+export const EXAMPLE_RELATED_PERSON_UPSERT_BUNDLE_PAYLOAD = {
+    thid: 'relatedperson-upsert-example-001',
+    body: {
+        resourceType: 'Bundle',
+        type: 'batch',
+        entry: [{
+                resource: {
+                    resourceType: EXAMPLE_RELATED_PERSON_RESOURCE_TYPE,
+                    id: 'grandfather-001',
+                    patient: { reference: EXAMPLE_SUBJECT_DID },
+                    relationship: [{ text: 'Grandfather' }],
+                    name: [{ text: EXAMPLE_RELATED_PERSON_DISPLAY_NAME }],
+                },
+            }],
+    },
+};
+/** @deprecated Use `EXAMPLE_RELATED_PERSON_UPSERT_BUNDLE_PAYLOAD`. */
+export const EXAMPLE_RELATED_PERSON_PAYLOAD = EXAMPLE_RELATED_PERSON_UPSERT_BUNDLE_PAYLOAD;
+/**
+ * Legacy JSON:API-style shell still referenced by older pass-through tests.
+ */
+export const EXAMPLE_RELATED_PERSON_BATCH_DATA_PAYLOAD = {
     body: {
         data: [
             {
-                type: 'RelatedPerson',
+                type: EXAMPLE_RELATED_PERSON_RESOURCE_TYPE,
+            },
+        ],
+    },
+};
+/**
+ * FHIR-shaped example used to demonstrate identifier-first operational
+ * normalization before claims-first processing.
+ */
+export const EXAMPLE_RELATED_PERSON_FHIR_RESOURCE = {
+    resourceType: EXAMPLE_RELATED_PERSON_RESOURCE_TYPE,
+    id: EXAMPLE_RELATED_PERSON_INTERNAL_RESOURCE_ID,
+    identifier: [{ value: EXAMPLE_RELATED_PERSON_IDENTIFIER }],
+    active: true,
+    patient: { reference: EXAMPLE_SUBJECT_DID },
+    relationship: [{ coding: [{ code: EXAMPLE_RELATED_PERSON_ROLE.split('|')[1], system: HL7_CODING_SYSTEM_V3_ROLE_CODE }] }],
+    telecom: [{ value: `mailto:${EXAMPLE_EMAIL_RELATED_PERSON}` }],
+};
+export const EXAMPLE_RELATED_PERSON_DISABLE_SEARCH_PARAMS = {
+    identifier: EXAMPLE_RELATED_PERSON_IDENTIFIER,
+};
+export const EXAMPLE_RELATED_PERSON_LIST_RECORD_ACTIVE = {
+    id: EXAMPLE_RELATED_PERSON_INTERNAL_RESOURCE_ID,
+    meta: {
+        status: 'active',
+    },
+    resource: {
+        resourceType: EXAMPLE_RELATED_PERSON_RESOURCE_TYPE,
+        id: EXAMPLE_RELATED_PERSON_INTERNAL_RESOURCE_ID,
+        meta: {
+            claims: {
+                '@context': EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API,
+                [RelatedPersonClaim.Identifier]: EXAMPLE_RELATED_PERSON_IDENTIFIER,
+                [RelatedPersonClaim.Patient]: EXAMPLE_SUBJECT_DID,
+                [RelatedPersonClaim.Telecom]: `mailto:${EXAMPLE_EMAIL_RELATED_PERSON}`,
+                [RelatedPersonClaim.Relationship]: EXAMPLE_RELATED_PERSON_ROLE,
+                [RelatedPersonClaim.Name]: EXAMPLE_RELATED_PERSON_DISPLAY_NAME,
+                [RelatedPersonClaim.Active]: 'true',
             },
+        },
+    },
+};
+export const EXAMPLE_RELATED_PERSON_LIST_RECORD_INACTIVE = {
+    id: 'related-person-internal-002',
+    meta: {
+        status: 'inactive',
+    },
+    resource: {
+        resourceType: EXAMPLE_RELATED_PERSON_RESOURCE_TYPE,
+        id: 'related-person-internal-002',
+        meta: {
+            claims: {
+                '@context': EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API,
+                [RelatedPersonClaim.Identifier]: EXAMPLE_RELATED_PERSON_INACTIVE_IDENTIFIER,
+                [RelatedPersonClaim.Patient]: EXAMPLE_SUBJECT_DID,
+                [RelatedPersonClaim.Telecom]: `mailto:${EXAMPLE_RELATED_PERSON_INACTIVE_EMAIL}`,
+                [RelatedPersonClaim.Relationship]: EXAMPLE_RELATED_PERSON_INACTIVE_RELATIONSHIP,
+                [RelatedPersonClaim.Name]: EXAMPLE_RELATED_PERSON_INACTIVE_NAME,
+                [RelatedPersonClaim.Active]: 'false',
+            },
+        },
+    },
+};
+export const EXAMPLE_RELATED_PERSON_LIST_RESPONSE_BODY = {
+    body: {
+        data: [
+            EXAMPLE_RELATED_PERSON_LIST_RECORD_ACTIVE,
+            EXAMPLE_RELATED_PERSON_LIST_RECORD_INACTIVE,
         ],
     },
 };
+export const EXAMPLE_RELATED_PERSON_INACTIVE_STATUS = InteroperableLifecycleStatuses.Inactive;
+export const EXAMPLE_RELATED_PERSON_PURGED_STATUS = InteroperableLifecycleStatuses.Purged;