vet-data-utils-ts 0.5.10 → 0.5.14

package/dist/organization-application.d.ts

@@ -23,6 +23,7 @@ export type ReusableOrganizationApplication = Readonly<{
     regionalId: boolean;
     subdivisionCode?: string;
     officialLicense?: string;
+    officialPhone?: string;
     legalRepresentative: Readonly<{
         name: string;
         email: string;
@@ -49,3 +50,5 @@ export declare function organizationServiceTypeForParticipationRoles(roles: read
  * object and remain inside the BFF/high-level Node runtime.
  */
 export declare function parseReusableOrganizationApplication(input: unknown): ReusableOrganizationApplication;
+/** Normalizes an optional official organization telephone to E.164 using the selected jurisdiction calling code. */
+export declare function normalizeOptionalOrganizationOfficialPhone(value: unknown, defaultCallingCode: unknown): string | undefined;

package/dist/organization-application.js

@@ -91,6 +91,7 @@ export function parseReusableOrganizationApplication(input) {
         regionalId,
         ...(subdivisionCode ? { subdivisionCode } : {}),
         ...(optional(value.officialLicense) ? { officialLicense: optional(value.officialLicense) } : {}),
+        ...(optional(value.officialPhone) ? { officialPhone: normalizeOptionalOrganizationOfficialPhone(value.officialPhone, value.defaultPhoneCallingCode) } : {}),
         legalRepresentative: Object.freeze({
             name: required(legalRepresentative.name, 'organization_legal_representative_name_required'),
             email: legalEmail,
@@ -99,6 +100,24 @@ export function parseReusableOrganizationApplication(input) {
         participationRoles: Object.freeze([...new Set(selectedRoles)]),
     });
 }
+/** Normalizes an optional official organization telephone to E.164 using the selected jurisdiction calling code. */
+export function normalizeOptionalOrganizationOfficialPhone(value, defaultCallingCode) {
+    const raw = optional(value);
+    if (!raw)
+        return undefined;
+    let compact = raw.replace(/^tel:/i, '').replace(/[\s().-]/g, '');
+    if (compact.startsWith('00'))
+        compact = `+${compact.slice(2)}`;
+    if (!compact.startsWith('+')) {
+        const callingCode = String(defaultCallingCode ?? '').trim().replace(/^00/, '+');
+        if (!/^\+[1-9]\d{0,2}$/.test(callingCode))
+            throw new TypeError('organization_official_phone_calling_code_required');
+        compact = `${callingCode}${compact.replace(/^0/, '')}`;
+    }
+    if (!/^\+[1-9]\d{7,14}$/.test(compact))
+        throw new TypeError('organization_official_phone_invalid');
+    return compact;
+}
 function record(value, error) {
     if (!value || typeof value !== 'object' || Array.isArray(value))
         throw new TypeError(error);

package/dist/scheduling.d.ts

@@ -115,9 +115,23 @@ export declare function buildVeterinaryAppointmentResponseResource(input: Readon
     appointmentReference: string;
     actorReference: string;
     participantStatus: string;
+    respondedAt?: string;
     proposedNewTime?: boolean;
     start?: string;
     end?: string;
+    notificationRecipientReference?: string;
+    notificationRecipientEmail?: string;
+}>): ClaimsFirstResource;
+/** Builds the FHIR-like Communication that an adapter may render as the additional English clinic email. */
+export declare function buildVeterinaryAppointmentResponseNotificationResource(input: Readonly<{
+    id: string;
+    responseReference: string;
+    appointmentReference: string;
+    senderReference: string;
+    recipientReference: string;
+    participantStatus: string;
+    sentAt: string;
+    language: string;
 }>): ClaimsFirstResource;
 /** Builds a searchable claims-first FHIR R5 Appointment with a seven-day confirmation due time. */
 export declare function buildVeterinaryAppointmentResource(input: Readonly<{
@@ -129,6 +143,9 @@ export declare function buildVeterinaryAppointmentResource(input: Readonly<{
     actorReferences: readonly string[];
     locationReference?: string;
     confirmationDueAt?: string;
+    userSelected?: boolean;
+    clinicRecipientReference?: string;
+    clinicRecipientEmail?: string;
 }>): ClaimsFirstResource;
 /** Builds the durable web inbox notification when a schedule change displaces an appointment. */
 export declare function buildVeterinaryAppointmentNotificationResource(input: Readonly<{

package/dist/scheduling.js

@@ -14,8 +14,8 @@ export const VeterinarySchedulingFlatClaimCatalog = Object.freeze({
     Location: Object.freeze(['Location.identifier', 'Location.status', 'Location.mode', 'Location.name', 'Location.description', 'Location.position.latitude', 'Location.position.longitude', 'Location.position.altitude', 'Location.managingOrganization', 'Location.characteristic', 'VeterinaryLocation.photoUrl']),
     Schedule: Object.freeze(['Schedule.identifier', 'Schedule.active', 'Schedule.name', 'Schedule.actor', 'Schedule.planningHorizon.start', 'Schedule.planningHorizon.end']),
     Slot: Object.freeze(['Slot.identifier', 'Slot.schedule', 'Slot.status', 'Slot.start', 'Slot.end', 'Slot.service-category', 'Slot.service-type', 'Slot.specialty', 'VeterinarySlot.location', 'VeterinarySlot.timeZone']),
-    Appointment: Object.freeze(['Appointment.identifier', 'Appointment.status', 'Appointment.description', 'Appointment.note', 'Appointment.start', 'Appointment.end', 'Appointment.slot', 'Appointment.actor', 'Appointment.location', 'VeterinaryAppointment.confirmationDueAt', 'VeterinaryAppointment.reschedulingReason']),
-    AppointmentResponse: Object.freeze(['AppointmentResponse.identifier', 'AppointmentResponse.appointment', 'AppointmentResponse.actor', 'AppointmentResponse.participantStatus', 'AppointmentResponse.proposedNewTime', 'AppointmentResponse.start', 'AppointmentResponse.end']),
+    Appointment: Object.freeze(['Appointment.identifier', 'Appointment.status', 'Appointment.description', 'Appointment.note', 'Appointment.start', 'Appointment.end', 'Appointment.slot', 'Appointment.actor', 'Appointment.location', 'Appointment.user-selected', 'VeterinaryAppointment.confirmationDueAt', 'VeterinaryAppointment.reschedulingReason', 'VeterinaryAppointment.clinicRecipient', 'VeterinaryAppointment.clinicEmail']),
+    AppointmentResponse: Object.freeze(['AppointmentResponse.identifier', 'AppointmentResponse.appointment', 'AppointmentResponse.actor', 'AppointmentResponse.participantStatus', 'AppointmentResponse.proposedNewTime', 'AppointmentResponse.start', 'AppointmentResponse.end', 'VeterinaryAppointmentResponse.respondedAt', 'VeterinaryAppointmentResponse.recipient', 'VeterinaryAppointmentResponse.recipientEmail']),
 });
 /** Validates the claims-only wire shape and normalizes scalar builder values to indexed strings. */
 export function normalizeVeterinarySchedulingFlatClaimsResource(input) {
@@ -177,7 +177,37 @@ export function buildVeterinaryAppointmentResponseResource(input) {
         throw new Error('appointment_response_time_incomplete');
     if (input.start && input.end && Date.parse(input.start) >= Date.parse(input.end))
         throw new Error('appointment_response_time_invalid');
-    return claimsResource('AppointmentResponse', input.id, { 'AppointmentResponse.appointment': required(input.appointmentReference, 'appointment_reference_required'), 'AppointmentResponse.actor': required(input.actorReference, 'appointment_response_actor_required'), 'AppointmentResponse.participantStatus': input.participantStatus, ...(input.proposedNewTime === undefined ? {} : { 'AppointmentResponse.proposedNewTime': input.proposedNewTime }), ...(input.start ? { 'AppointmentResponse.start': input.start, 'AppointmentResponse.end': input.end } : {}) });
+    const respondedAt = input.respondedAt || new Date().toISOString();
+    if (!Number.isFinite(Date.parse(respondedAt)))
+        throw new Error('appointment_response_responded_at_invalid');
+    const hasRecipientReference = Boolean(input.notificationRecipientReference?.trim());
+    const hasRecipientEmail = Boolean(input.notificationRecipientEmail?.trim());
+    if (hasRecipientReference !== hasRecipientEmail)
+        throw new Error('appointment_response_notification_recipient_incomplete');
+    if (hasRecipientEmail && !/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(input.notificationRecipientEmail.trim()))
+        throw new Error('appointment_response_notification_email_invalid');
+    return claimsResource('AppointmentResponse', input.id, { 'AppointmentResponse.appointment': required(input.appointmentReference, 'appointment_reference_required'), 'AppointmentResponse.actor': required(input.actorReference, 'appointment_response_actor_required'), 'AppointmentResponse.participantStatus': input.participantStatus, 'VeterinaryAppointmentResponse.respondedAt': new Date(respondedAt).toISOString(), ...(hasRecipientReference ? { 'VeterinaryAppointmentResponse.recipient': input.notificationRecipientReference.trim(), 'VeterinaryAppointmentResponse.recipientEmail': input.notificationRecipientEmail.trim().toLowerCase() } : {}), ...(input.proposedNewTime === undefined ? {} : { 'AppointmentResponse.proposedNewTime': input.proposedNewTime }), ...(input.start ? { 'AppointmentResponse.start': input.start, 'AppointmentResponse.end': input.end } : {}) });
+}
+/** Builds the FHIR-like Communication that an adapter may render as the additional English clinic email. */
+export function buildVeterinaryAppointmentResponseNotificationResource(input) {
+    if (input.language !== 'en')
+        throw new Error('appointment_response_notification_language_unsupported');
+    if (!Object.values(AppointmentResponseStatuses).includes(input.participantStatus))
+        throw new Error('appointment_response_status_invalid');
+    if (!Number.isFinite(Date.parse(input.sentAt)))
+        throw new Error('appointment_response_notification_sent_at_invalid');
+    const statusText = Object.freeze({ accepted: 'accepted', declined: 'declined', tentative: 'tentatively changed', 'needs-action': 'left awaiting action', 'entered-in-error': 'marked as entered in error' });
+    return claimsResource('Communication', input.id, {
+        'Communication.identifier': input.id,
+        'Communication.status': 'completed',
+        'Communication.category': 'http://terminology.hl7.org/CodeSystem/communication-category|notification',
+        'Communication.recipient': required(input.recipientReference, 'appointment_response_notification_recipient_required'),
+        'Communication.sender': required(input.senderReference, 'appointment_response_notification_sender_required'),
+        'Communication.sent': new Date(input.sentAt).toISOString(),
+        'Communication.topic': 'https://vetchain.app/fhir/CodeSystem/communication-topic|appointment-response',
+        'Communication.content-reference': Object.freeze([required(input.responseReference, 'appointment_response_reference_required'), required(input.appointmentReference, 'appointment_reference_required')]),
+        'Communication.text': `The appointment was ${statusText[input.participantStatus]}.`,
+    });
 }
 /** Builds a searchable claims-first FHIR R5 Appointment with a seven-day confirmation due time. */
 export function buildVeterinaryAppointmentResource(input) {
@@ -187,19 +217,28 @@ export function buildVeterinaryAppointmentResource(input) {
     const end = Date.parse(input.end);
     if (!Number.isFinite(start) || !Number.isFinite(end) || start >= end)
         throw new Error('appointment_time_invalid');
-    if (!input.slotReferences.length)
+    const userSelected = input.userSelected ?? false;
+    if (!input.slotReferences.length && !userSelected)
         throw new Error('appointment_slot_required');
     if (!input.actorReferences.length)
         throw new Error('appointment_actor_required');
     const confirmationDueAt = input.confirmationDueAt || new Date(start - 7 * 24 * 60 * 60 * 1000).toISOString();
     if (!Number.isFinite(Date.parse(confirmationDueAt)) || Date.parse(confirmationDueAt) >= start)
         throw new Error('appointment_confirmation_due_invalid');
+    const hasClinicRecipient = Boolean(input.clinicRecipientReference?.trim());
+    const hasClinicEmail = Boolean(input.clinicRecipientEmail?.trim());
+    if (hasClinicRecipient !== hasClinicEmail)
+        throw new Error('appointment_clinic_notification_recipient_incomplete');
+    if (hasClinicEmail && !/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(input.clinicRecipientEmail.trim()))
+        throw new Error('appointment_clinic_email_invalid');
     return claimsResource('Appointment', input.id, {
         'Appointment.status': input.status,
         'Appointment.start': new Date(start).toISOString(),
         'Appointment.end': new Date(end).toISOString(),
-        'Appointment.slot': Object.freeze([...input.slotReferences]),
+        ...(input.slotReferences.length ? { 'Appointment.slot': Object.freeze([...input.slotReferences]) } : {}),
         'Appointment.actor': Object.freeze([...input.actorReferences]),
+        'Appointment.user-selected': userSelected,
+        ...(hasClinicRecipient ? { 'VeterinaryAppointment.clinicRecipient': input.clinicRecipientReference.trim(), 'VeterinaryAppointment.clinicEmail': input.clinicRecipientEmail.trim().toLowerCase() } : {}),
         ...(input.locationReference ? { 'Appointment.location': required(input.locationReference, 'appointment_location_required') } : {}),
         'VeterinaryAppointment.confirmationDueAt': new Date(confirmationDueAt).toISOString(),
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-data-utils-ts",
-  "version": "0.5.10",
+  "version": "0.5.14",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",