vet-data-utils-ts 0.5.0 → 0.5.2

package/README.md

@@ -10,12 +10,27 @@ veterinary assistant intents.
 
 FHIR R5 ResearchStudy screens consume the exact 25 resource-specific search
 parameters and the separate associated-party projection from
-`vet-data-utils-ts/research-study`. The complete `associatedParty` object stays
-beside each flat projection so repeating roles, periods and classifiers cannot
-be attributed to the wrong party. A party classifier describes an organization
-category; it never represents Consent or CRUDS authorization. See
+`vet-data-utils-ts/research-study`. GW persistence receives only
+`resourceType`, `id` and flat `resource.meta.claims`; each party uses its own
+`ResearchStudy.party-*` claim map so repeating roles, periods and classifiers
+cannot be attributed to the wrong party. A party classifier describes an
+organization category; it never represents Consent or CRUDS authorization. See
 [`docs/research-study-r5-contract.md`](docs/research-study-r5-contract.md).
 
+ResearchStudy professional teams use native FHIR R5 Group resources from
+`vet-data-utils-ts/group`: required type and membership codes, the exact twelve
+resource-specific SearchParameters, canonical flat claim projection and
+enumerated PractitionerRole member normalization. Group membership is
+descriptive and never carries authorization, permission or scope. See
+[`docs/group-r5-contract.md`](docs/group-r5-contract.md).
+
+`projectResearchStudyR5FlatClaimsResource()` and
+`projectGroupR5FlatClaimsResource()` create the minimal claims-first resource;
+their repeating-party/member companions return one correlated resource per
+future PATCH. The matching `normalize*FlatClaimsResource()` functions reject
+nested FHIR persistence fields and unknown claims. Native FHIR JSON remains an
+explicit import, projection or export boundary.
+
 Reusable Communication screens receive immutable workflow presets from
 `vet-data-utils-ts/communication`. The research-agreement screen is fixed to
 FHIR `notification` plus HL7 v3 ActReason `HRESCH` and does not expose a topic

package/dist/group.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Browser-safe FHIR R5 Group contract for research-team descriptions.
+ *
+ * Group membership is descriptive. It never grants authorization, permission
+ * or a SMART scope; those decisions remain separate Consent and credential
+ * contracts.
+ *
+ * @see https://hl7.org/fhir/R5/group.html
+ * @see https://hl7.org/fhir/R5/group-search.html
+ */
+export declare const GroupR5Version: "5.0.0";
+export declare const GroupR5TypeSystem: "http://hl7.org/fhir/group-type";
+export declare const GroupR5TypeCodes: readonly ["person", "animal", "practitioner", "device", "careteam", "healthcareservice", "location", "organization", "relatedperson", "specimen"];
+export type GroupR5TypeCode = (typeof GroupR5TypeCodes)[number];
+export declare const GroupR5MembershipSystem: "http://hl7.org/fhir/group-membership-basis";
+export declare const GroupR5MembershipCodes: readonly ["definitional", "enumerated"];
+export type GroupR5MembershipCode = (typeof GroupR5MembershipCodes)[number];
+export declare const GroupR5Bindings: Readonly<{
+    readonly type: Readonly<{
+        valueSet: "http://hl7.org/fhir/ValueSet/group-type";
+        strength: "required";
+    }>;
+    readonly membership: Readonly<{
+        valueSet: "http://hl7.org/fhir/ValueSet/group-membership-basis";
+        strength: "required";
+    }>;
+}>;
+export type GroupSearchParameterType = 'composite' | 'reference' | 'string' | 'token';
+export type GroupR5SearchParameter = Readonly<{
+    code: string;
+    type: GroupSearchParameterType;
+    expression: string;
+    components: readonly string[];
+}>;
+/** Exact resource-specific SearchParameters published by FHIR R5 5.0.0. */
+export declare const GroupR5SearchParameterCatalog: readonly GroupR5SearchParameter[];
+declare const standardSearchClaims: readonly `Group.${string}`[];
+/** Canonical claims derived only from the official resource-specific catalogue. */
+export declare const GroupFlatClaimCatalog: Readonly<{
+    standardSearch: readonly `Group.${string}`[];
+    all: readonly `Group.${string}`[];
+}>;
+export type GroupR5SearchClaim = (typeof standardSearchClaims)[number];
+export type GroupR5SearchClaims = Readonly<Partial<Record<GroupR5SearchClaim, readonly string[]>>>;
+export type GroupR5FlatClaimsResource = Readonly<{
+    resourceType: 'Group';
+    id: string;
+    meta: Readonly<{
+        claims: Readonly<Record<string, readonly string[]>>;
+    }>;
+}>;
+export type GroupR5Reference = Readonly<{
+    reference: string;
+    type?: string;
+    display?: string;
+}>;
+export type GroupR5Period = Readonly<{
+    start?: string;
+    end?: string;
+}>;
+export type GroupPractitionerRoleMember = Readonly<{
+    entity: Readonly<{
+        reference: `PractitionerRole/${string}`;
+        type: 'PractitionerRole';
+        display?: string;
+    }>;
+    period?: GroupR5Period;
+    inactive?: boolean;
+}>;
+export type GroupR5ResearchTeam = Readonly<Record<string, unknown> & {
+    resourceType: 'Group';
+    id?: string;
+    type: 'practitioner';
+    membership: 'enumerated';
+    member: readonly GroupPractitionerRoleMember[];
+}>;
+/**
+ * Normalizes the members used by an enumerated professional research team.
+ * Every entity is a native PractitionerRole reference; a Practitioner or an
+ * employee identifier cannot substitute for the registered role assignment.
+ */
+export declare function normalizeGroupPractitionerRoleMembers(input: unknown): readonly GroupPractitionerRoleMember[];
+/**
+ * Normalizes the Group profile used to describe an explicit professional
+ * ResearchStudy team. This data is descriptive and authorization-shaped
+ * properties are rejected at every depth.
+ */
+export declare function normalizeGroupR5ResearchTeam(input: unknown): GroupR5ResearchTeam;
+/**
+ * Projects all populated official resource-specific R5 Group SearchParameters
+ * into flat `resource.meta.claims`. A referenced characteristic is indexed by
+ * `characteristic-reference`, not as the token-valued `value` parameter.
+ *
+ * @see https://hl7.org/fhir/R5/group-search.html
+ */
+export declare function projectGroupR5SearchClaims(input: unknown): GroupR5SearchClaims;
+/** Projects native-shaped Group input to the claims-only GW persistence shape. */
+export declare function projectGroupR5FlatClaimsResource(input: unknown): GroupR5FlatClaimsResource;
+/** Projects one correlated claims-only GW resource per PractitionerRole member. */
+export declare function projectGroupPractitionerRoleMemberFlatClaimResources(input: Readonly<{
+    groupId: string;
+    members: unknown;
+}>): readonly GroupR5FlatClaimsResource[];
+/** Validates and freezes a claims-only Group GW resource. */
+export declare function normalizeGroupR5FlatClaimsResource(input: unknown): GroupR5FlatClaimsResource;
+export {};

package/dist/group.js

@@ -0,0 +1,286 @@
+/**
+ * Browser-safe FHIR R5 Group contract for research-team descriptions.
+ *
+ * Group membership is descriptive. It never grants authorization, permission
+ * or a SMART scope; those decisions remain separate Consent and credential
+ * contracts.
+ *
+ * @see https://hl7.org/fhir/R5/group.html
+ * @see https://hl7.org/fhir/R5/group-search.html
+ */
+export const GroupR5Version = '5.0.0';
+export const GroupR5TypeSystem = 'http://hl7.org/fhir/group-type';
+export const GroupR5TypeCodes = Object.freeze([
+    'person',
+    'animal',
+    'practitioner',
+    'device',
+    'careteam',
+    'healthcareservice',
+    'location',
+    'organization',
+    'relatedperson',
+    'specimen',
+]);
+export const GroupR5MembershipSystem = 'http://hl7.org/fhir/group-membership-basis';
+export const GroupR5MembershipCodes = Object.freeze(['definitional', 'enumerated']);
+export const GroupR5Bindings = Object.freeze({
+    type: Object.freeze({
+        valueSet: 'http://hl7.org/fhir/ValueSet/group-type',
+        strength: 'required',
+    }),
+    membership: Object.freeze({
+        valueSet: 'http://hl7.org/fhir/ValueSet/group-membership-basis',
+        strength: 'required',
+    }),
+});
+const searchParameter = (code, type, expression, components = []) => Object.freeze({
+    code,
+    type,
+    expression,
+    components: Object.freeze([...components]),
+});
+/** Exact resource-specific SearchParameters published by FHIR R5 5.0.0. */
+export const GroupR5SearchParameterCatalog = Object.freeze([
+    searchParameter('characteristic', 'token', 'Group.characteristic.code'),
+    searchParameter('characteristic-reference', 'reference', '(Group.characteristic.value.ofType(Reference))'),
+    searchParameter('characteristic-value', 'composite', 'Group.characteristic', [
+        'http://hl7.org/fhir/SearchParameter/Group-characteristic',
+        'http://hl7.org/fhir/SearchParameter/Group-value',
+    ]),
+    searchParameter('code', 'token', 'Group.code'),
+    searchParameter('exclude', 'token', 'Group.characteristic.exclude'),
+    searchParameter('identifier', 'token', 'Group.identifier'),
+    searchParameter('managing-entity', 'reference', 'Group.managingEntity'),
+    searchParameter('member', 'reference', 'Group.member.entity'),
+    searchParameter('membership', 'token', 'Group.membership'),
+    searchParameter('name', 'string', 'Group.name'),
+    searchParameter('type', 'token', 'Group.type'),
+    searchParameter('value', 'token', '(Group.characteristic.value.ofType(CodeableConcept)) | (Group.characteristic.value.ofType(boolean))'),
+]);
+const standardSearchClaims = Object.freeze(GroupR5SearchParameterCatalog.map(parameter => `Group.${parameter.code}`));
+/** Canonical claims derived only from the official resource-specific catalogue. */
+export const GroupFlatClaimCatalog = Object.freeze({
+    standardSearch: standardSearchClaims,
+    all: standardSearchClaims,
+});
+/**
+ * Normalizes the members used by an enumerated professional research team.
+ * Every entity is a native PractitionerRole reference; a Practitioner or an
+ * employee identifier cannot substitute for the registered role assignment.
+ */
+export function normalizeGroupPractitionerRoleMembers(input) {
+    if (!Array.isArray(input))
+        throw new TypeError('group_members_invalid');
+    return Object.freeze(input.map((value, index) => {
+        if (!isRecord(value) || containsAuthorizationProperty(value)) {
+            throw new TypeError(containsAuthorizationProperty(value) ? 'group_authorization_property_forbidden' : `group_member_${index}_invalid`);
+        }
+        if (!isRecord(value.entity))
+            throw new TypeError(`group_member_${index}_practitioner_role_reference_invalid`);
+        const reference = optionalString(value.entity.reference);
+        const declaredType = optionalString(value.entity.type);
+        if (!reference || !/^PractitionerRole\/[A-Za-z0-9.-]{1,64}$/.test(reference) || (declaredType && declaredType !== 'PractitionerRole')) {
+            throw new TypeError(`group_member_${index}_practitioner_role_reference_invalid`);
+        }
+        const display = optionalString(value.entity.display);
+        const period = value.period === undefined ? undefined : normalizePeriod(value.period, index);
+        if (value.inactive !== undefined && typeof value.inactive !== 'boolean') {
+            throw new TypeError(`group_member_${index}_inactive_invalid`);
+        }
+        return Object.freeze({
+            entity: Object.freeze({
+                reference: reference,
+                type: 'PractitionerRole',
+                ...(display ? { display } : {}),
+            }),
+            ...(period ? { period } : {}),
+            ...(value.inactive !== undefined ? { inactive: value.inactive } : {}),
+        });
+    }));
+}
+/**
+ * Normalizes the Group profile used to describe an explicit professional
+ * ResearchStudy team. This data is descriptive and authorization-shaped
+ * properties are rejected at every depth.
+ */
+export function normalizeGroupR5ResearchTeam(input) {
+    if (!isRecord(input) || input.resourceType !== 'Group')
+        throw new TypeError('group_resource_invalid');
+    if (containsAuthorizationProperty(input))
+        throw new TypeError('group_authorization_property_forbidden');
+    if (input.type !== 'practitioner')
+        throw new TypeError('group_research_team_type_invalid');
+    if (input.membership !== 'enumerated')
+        throw new TypeError('group_research_team_membership_invalid');
+    const member = normalizeGroupPractitionerRoleMembers(input.member);
+    return Object.freeze({ ...input, type: 'practitioner', membership: 'enumerated', member });
+}
+/**
+ * Projects all populated official resource-specific R5 Group SearchParameters
+ * into flat `resource.meta.claims`. A referenced characteristic is indexed by
+ * `characteristic-reference`, not as the token-valued `value` parameter.
+ *
+ * @see https://hl7.org/fhir/R5/group-search.html
+ */
+export function projectGroupR5SearchClaims(input) {
+    if (!isRecord(input) || input.resourceType !== 'Group')
+        throw new TypeError('group_resource_invalid');
+    if (containsAuthorizationProperty(input))
+        throw new TypeError('group_authorization_property_forbidden');
+    if (!GroupR5TypeCodes.includes(input.type))
+        throw new TypeError('group_type_invalid');
+    if (!GroupR5MembershipCodes.includes(input.membership)) {
+        throw new TypeError('group_membership_invalid');
+    }
+    const characteristics = normalizeRecords(input.characteristic, 'group_characteristic_invalid');
+    const characteristicCodes = characteristics.flatMap(item => conceptTokens(item.code));
+    const characteristicValues = characteristics.flatMap(characteristicTokenValues);
+    const claims = {};
+    addClaim(claims, 'Group.characteristic', characteristicCodes);
+    addClaim(claims, 'Group.characteristic-reference', characteristics.flatMap(item => referenceTokens(item.valueReference)));
+    addClaim(claims, 'Group.characteristic-value', characteristics.flatMap(item => conceptTokens(item.code).flatMap(code => characteristicTokenValues(item).map(value => `${code}$${value}`))));
+    addClaim(claims, 'Group.code', conceptTokens(input.code));
+    addClaim(claims, 'Group.exclude', characteristics.flatMap(item => typeof item.exclude === 'boolean' ? [String(item.exclude)] : []));
+    addClaim(claims, 'Group.identifier', identifierTokens(input.identifier));
+    addClaim(claims, 'Group.managing-entity', referenceTokens(input.managingEntity));
+    addClaim(claims, 'Group.member', normalizeRecords(input.member, 'group_members_invalid').flatMap(item => referenceTokens(item.entity)));
+    addClaim(claims, 'Group.membership', [input.membership]);
+    addClaim(claims, 'Group.name', strings(input.name));
+    addClaim(claims, 'Group.type', [input.type]);
+    addClaim(claims, 'Group.value', characteristicValues);
+    return Object.freeze(claims);
+}
+/** Projects native-shaped Group input to the claims-only GW persistence shape. */
+export function projectGroupR5FlatClaimsResource(input) {
+    if (!isRecord(input) || input.resourceType !== 'Group')
+        throw new TypeError('group_resource_invalid');
+    const id = fhirId(input.id, 'group_flat_resource_invalid');
+    if (Array.isArray(input.member) && input.member.length > 0)
+        throw new TypeError('group_members_require_separate_resources');
+    return normalizeGroupR5FlatClaimsResource({
+        resourceType: 'Group',
+        id,
+        meta: { claims: projectGroupR5SearchClaims(input) },
+    });
+}
+/** Projects one correlated claims-only GW resource per PractitionerRole member. */
+export function projectGroupPractitionerRoleMemberFlatClaimResources(input) {
+    const id = fhirId(input.groupId, 'group_flat_resource_invalid');
+    const members = normalizeGroupPractitionerRoleMembers(input.members);
+    return Object.freeze(members.map(member => normalizeGroupR5FlatClaimsResource({
+        resourceType: 'Group',
+        id,
+        meta: {
+            claims: projectGroupR5SearchClaims({
+                resourceType: 'Group',
+                id,
+                type: 'practitioner',
+                membership: 'enumerated',
+                member: [member],
+            }),
+        },
+    })));
+}
+/** Validates and freezes a claims-only Group GW resource. */
+export function normalizeGroupR5FlatClaimsResource(input) {
+    if (!isRecord(input)
+        || input.resourceType !== 'Group'
+        || Object.keys(input).some(key => !['resourceType', 'id', 'meta'].includes(key))) {
+        throw new TypeError('group_flat_resource_invalid');
+    }
+    const id = fhirId(input.id, 'group_flat_resource_invalid');
+    if (!isRecord(input.meta) || !isRecord(input.meta.claims))
+        throw new TypeError('group_flat_resource_invalid');
+    const claims = {};
+    for (const [name, rawValues] of Object.entries(input.meta.claims)) {
+        if (!GroupFlatClaimCatalog.all.includes(name)
+            || !Array.isArray(rawValues)
+            || rawValues.length === 0
+            || rawValues.some(value => typeof value !== 'string' || !value.trim())) {
+            throw new TypeError('group_flat_claim_invalid');
+        }
+        claims[name] = Object.freeze(rawValues.map(value => value.trim()));
+    }
+    return Object.freeze({ resourceType: 'Group', id, meta: Object.freeze({ claims: Object.freeze(claims) }) });
+}
+function addClaim(claims, name, values) {
+    const normalized = [...new Set(values.flatMap(value => strings(value)))];
+    if (normalized.length > 0)
+        claims[name] = Object.freeze(normalized);
+}
+function identifierTokens(value) {
+    return normalizeRecords(value, 'group_identifier_invalid').flatMap(identifier => {
+        const system = optionalString(identifier.system);
+        const identifierValue = optionalString(identifier.value);
+        return identifierValue ? [`${system ? `${system}|` : ''}${identifierValue}`] : [];
+    });
+}
+function conceptTokens(value) {
+    if (!isRecord(value))
+        return [];
+    const coding = normalizeRecords(value.coding, 'group_coding_invalid').flatMap(item => {
+        const system = optionalString(item.system);
+        const code = optionalString(item.code);
+        return code ? [`${system ? `${system}|` : ''}${code}`] : [];
+    });
+    return coding.length > 0 ? coding : strings(value.text);
+}
+function characteristicTokenValues(value) {
+    if (typeof value.valueBoolean === 'boolean')
+        return [String(value.valueBoolean)];
+    return conceptTokens(value.valueCodeableConcept);
+}
+function referenceTokens(value) {
+    return isRecord(value) ? strings(value.reference) : [];
+}
+function normalizeRecords(value, error) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || !value.every(isRecord))
+        throw new TypeError(error);
+    return value;
+}
+function normalizePeriod(value, index) {
+    if (!isRecord(value))
+        throw new TypeError(`group_member_${index}_period_invalid`);
+    const start = optionalString(value.start);
+    const end = optionalString(value.end);
+    if (!start && !end)
+        throw new TypeError(`group_member_${index}_period_invalid`);
+    if ((start && !isFhirDateTime(start)) || (end && !isFhirDateTime(end))) {
+        throw new TypeError(`group_member_${index}_period_invalid`);
+    }
+    if (start && end && Date.parse(end) < Date.parse(start))
+        throw new TypeError(`group_member_${index}_period_invalid`);
+    return Object.freeze({ ...(start ? { start } : {}), ...(end ? { end } : {}) });
+}
+function containsAuthorizationProperty(value, seen = new WeakSet()) {
+    if (!value || typeof value !== 'object')
+        return false;
+    if (seen.has(value))
+        return false;
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.some(item => containsAuthorizationProperty(item, seen));
+    return Object.entries(value).some(([name, nested]) => ['authorization', 'permission', 'scope'].includes(name) || containsAuthorizationProperty(nested, seen));
+}
+function strings(value) {
+    const normalized = optionalString(value);
+    return normalized ? [normalized] : [];
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function isFhirDateTime(value) {
+    return /^\d{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12]\d|3[01])(?:T.+)?)?)?$/.test(value);
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function fhirId(value, error) {
+    const id = optionalString(value);
+    if (!id || !/^[A-Za-z0-9.-]{1,64}$/.test(id))
+        throw new TypeError(error);
+    return id;
+}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './clinical-terminology.js';
 export * from './digital-twin.js';
 export * from './emergency.js';
 export * from './financial.js';
+export * from './group.js';
 export * from './iso-jurisdictions.js';
 export * from './organization-application.js';
 export * from './research-study.js';

package/dist/index.js

@@ -5,6 +5,7 @@ export * from './clinical-terminology.js';
 export * from './digital-twin.js';
 export * from './emergency.js';
 export * from './financial.js';
+export * from './group.js';
 export * from './iso-jurisdictions.js';
 export * from './organization-application.js';
 export * from './research-study.js';

package/dist/research-study.d.ts

@@ -42,7 +42,7 @@ export type ResearchStudyR5SearchParameter = Readonly<{
 /** Exact resource-specific SearchParameters published by FHIR R5 5.0.0. */
 export declare const ResearchStudyR5SearchParameterCatalog: readonly ResearchStudyR5SearchParameter[];
 declare const standardSearchClaims: readonly `ResearchStudy.${string}`[];
-declare const associatedPartyClaims: readonly ["ResearchStudy.associated-party-name", "ResearchStudy.associated-party-role", "ResearchStudy.associated-party-period-start", "ResearchStudy.associated-party-period-end", "ResearchStudy.associated-party-classifier", "ResearchStudy.associated-party-party"];
+declare const associatedPartyClaims: readonly ["ResearchStudy.party-name", "ResearchStudy.party-role", "ResearchStudy.party-period-start", "ResearchStudy.party-period-end", "ResearchStudy.party-classifier", "ResearchStudy.party"];
 /**
  * Governed flat claims for ResearchStudy.
  *
@@ -53,7 +53,7 @@ declare const associatedPartyClaims: readonly ["ResearchStudy.associated-party-n
  */
 export declare const ResearchStudyFlatClaimCatalog: Readonly<{
     standardSearch: readonly `ResearchStudy.${string}`[];
-    associatedParty: readonly ["ResearchStudy.associated-party-name", "ResearchStudy.associated-party-role", "ResearchStudy.associated-party-period-start", "ResearchStudy.associated-party-period-end", "ResearchStudy.associated-party-classifier", "ResearchStudy.associated-party-party"];
+    associatedParty: readonly ["ResearchStudy.party-name", "ResearchStudy.party-role", "ResearchStudy.party-period-start", "ResearchStudy.party-period-end", "ResearchStudy.party-classifier", "ResearchStudy.party"];
     all: readonly `ResearchStudy.${string}`[];
 }>;
 export type ResearchStudyCoding = Readonly<{
@@ -89,6 +89,13 @@ export type ResearchStudyAssociatedPartyClaimProjection = Readonly<{
 }>;
 export type ResearchStudyR5SearchClaim = (typeof standardSearchClaims)[number];
 export type ResearchStudyR5SearchClaims = Readonly<Partial<Record<ResearchStudyR5SearchClaim, readonly string[]>>>;
+export type ResearchStudyR5FlatClaimsResource = Readonly<{
+    resourceType: 'ResearchStudy';
+    id: string;
+    meta: Readonly<{
+        claims: Readonly<Record<string, readonly string[]>>;
+    }>;
+}>;
 /**
  * Projects the official resource-specific R5 SearchParameters from one native
  * ResearchStudy into flat `resource.meta.claims`. Composite values use FHIR's
@@ -110,4 +117,13 @@ export declare function normalizeResearchStudyAssociatedParties(input: unknown):
  * required when a later Bundle PATCH changes one party.
  */
 export declare function projectResearchStudyAssociatedPartyClaims(input: unknown): readonly ResearchStudyAssociatedPartyClaimProjection[];
+/** Projects native-shaped study input to the claims-only GW persistence shape. */
+export declare function projectResearchStudyR5FlatClaimsResource(input: unknown): ResearchStudyR5FlatClaimsResource;
+/** Projects one correlated claims-only GW resource per associated party. */
+export declare function projectResearchStudyAssociatedPartyFlatClaimResources(input: Readonly<{
+    researchStudyId: string;
+    associatedParties: unknown;
+}>): readonly ResearchStudyR5FlatClaimsResource[];
+/** Validates and freezes a claims-only ResearchStudy GW resource. */
+export declare function normalizeResearchStudyR5FlatClaimsResource(input: unknown): ResearchStudyR5FlatClaimsResource;
 export {};

package/dist/research-study.js

@@ -90,12 +90,12 @@ export const ResearchStudyR5SearchParameterCatalog = Object.freeze([
 ]);
 const standardSearchClaims = Object.freeze(ResearchStudyR5SearchParameterCatalog.map(parameter => `ResearchStudy.${parameter.code}`));
 const associatedPartyClaims = Object.freeze([
-    'ResearchStudy.associated-party-name',
-    'ResearchStudy.associated-party-role',
-    'ResearchStudy.associated-party-period-start',
-    'ResearchStudy.associated-party-period-end',
-    'ResearchStudy.associated-party-classifier',
-    'ResearchStudy.associated-party-party',
+    'ResearchStudy.party-name',
+    'ResearchStudy.party-role',
+    'ResearchStudy.party-period-start',
+    'ResearchStudy.party-period-end',
+    'ResearchStudy.party-classifier',
+    'ResearchStudy.party',
 ]);
 /**
  * Governed flat claims for ResearchStudy.
@@ -171,15 +171,58 @@ export function projectResearchStudyAssociatedPartyClaims(input) {
     return Object.freeze(parties.map(party => Object.freeze({
         associatedParty: party,
         claims: Object.freeze({
-            'ResearchStudy.associated-party-name': Object.freeze(party.name ? [party.name] : []),
-            'ResearchStudy.associated-party-role': Object.freeze(conceptValues([party.role])),
-            'ResearchStudy.associated-party-period-start': Object.freeze((party.period || []).flatMap(period => period.start ? [period.start] : [])),
-            'ResearchStudy.associated-party-period-end': Object.freeze((party.period || []).flatMap(period => period.end ? [period.end] : [])),
-            'ResearchStudy.associated-party-classifier': Object.freeze(conceptValues(party.classifier || [])),
-            'ResearchStudy.associated-party-party': Object.freeze(party.party ? [party.party.reference] : []),
+            'ResearchStudy.party-name': Object.freeze(party.name ? [party.name] : []),
+            'ResearchStudy.party-role': Object.freeze(conceptValues([party.role])),
+            'ResearchStudy.party-period-start': Object.freeze((party.period || []).flatMap(period => period.start ? [period.start] : [])),
+            'ResearchStudy.party-period-end': Object.freeze((party.period || []).flatMap(period => period.end ? [period.end] : [])),
+            'ResearchStudy.party-classifier': Object.freeze(conceptValues(party.classifier || [])),
+            'ResearchStudy.party': Object.freeze(party.party ? [party.party.reference] : []),
         }),
     })));
 }
+/** Projects native-shaped study input to the claims-only GW persistence shape. */
+export function projectResearchStudyR5FlatClaimsResource(input) {
+    if (!isRecord(input) || input.resourceType !== 'ResearchStudy')
+        throw new TypeError('research_study_resource_invalid');
+    const id = fhirId(input.id, 'research_study_flat_resource_invalid');
+    if (input.associatedParty !== undefined)
+        throw new TypeError('research_study_parties_require_separate_resources');
+    return normalizeResearchStudyR5FlatClaimsResource({
+        resourceType: 'ResearchStudy',
+        id,
+        meta: { claims: projectResearchStudyR5SearchClaims(input) },
+    });
+}
+/** Projects one correlated claims-only GW resource per associated party. */
+export function projectResearchStudyAssociatedPartyFlatClaimResources(input) {
+    const id = fhirId(input.researchStudyId, 'research_study_flat_resource_invalid');
+    return Object.freeze(projectResearchStudyAssociatedPartyClaims(input.associatedParties).map(projection => {
+        const claims = Object.fromEntries(Object.entries(projection.claims).filter(([, values]) => values.length > 0));
+        return normalizeResearchStudyR5FlatClaimsResource({ resourceType: 'ResearchStudy', id, meta: { claims } });
+    }));
+}
+/** Validates and freezes a claims-only ResearchStudy GW resource. */
+export function normalizeResearchStudyR5FlatClaimsResource(input) {
+    if (!isRecord(input)
+        || input.resourceType !== 'ResearchStudy'
+        || Object.keys(input).some(key => !['resourceType', 'id', 'meta'].includes(key))) {
+        throw new TypeError('research_study_flat_resource_invalid');
+    }
+    const id = fhirId(input.id, 'research_study_flat_resource_invalid');
+    if (!isRecord(input.meta) || !isRecord(input.meta.claims))
+        throw new TypeError('research_study_flat_resource_invalid');
+    const claims = {};
+    for (const [name, rawValues] of Object.entries(input.meta.claims)) {
+        if (!ResearchStudyFlatClaimCatalog.all.includes(name)
+            || !Array.isArray(rawValues)
+            || rawValues.length === 0
+            || rawValues.some(value => typeof value !== 'string' || !value.trim())) {
+            throw new TypeError('research_study_flat_claim_invalid');
+        }
+        claims[name] = Object.freeze(rawValues.map(value => value.trim()));
+    }
+    return Object.freeze({ resourceType: 'ResearchStudy', id, meta: Object.freeze({ claims: Object.freeze(claims) }) });
+}
 function normalizeAssociatedParty(value, index) {
     if (!isRecord(value))
         throw new TypeError(`research_study_associated_party_${index}_invalid`);
@@ -399,3 +442,9 @@ function isFhirDateTime(value) {
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function fhirId(value, error) {
+    const id = optionalString(value);
+    if (!id || !/^[A-Za-z0-9.-]{1,64}$/.test(id))
+        throw new TypeError(error);
+    return id;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-data-utils-ts",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -36,6 +36,10 @@
       "types": "./dist/financial.d.ts",
       "default": "./dist/financial.js"
     },
+    "./group": {
+      "types": "./dist/group.d.ts",
+      "default": "./dist/group.js"
+    },
     "./iso-jurisdictions": {
       "types": "./dist/iso-jurisdictions.d.ts",
       "default": "./dist/iso-jurisdictions.js"