vet-sdk-core-ts 0.4.38 → 0.4.39

package/README.md

@@ -7,6 +7,12 @@ An animal is the first member of its own Individual Organization, so
 human that creates it is `Organization.owner`, the controller by default;
 `RESPRSN` must never be copied into the animal member.
 
+Name, birth date, exact NCBI species and optional breed are animal
+demographics. Breed remains separate descriptive text. Controller-authored
+demographics remain editable until a veterinarian attests them; attestation
+does not rewrite the original author, and later correction creates a new
+veterinarian-authored version.
+
 Use `buildVetChainAnimalDraftClaims(...)` while the name, exact NCBI species or
 public Card is missing. Only a draft for which
 `readVetChainAnimalOnboardingReadiness(...)` returns `ready: true` may be

package/dist/animal-onboarding.d.ts

@@ -11,6 +11,7 @@ export type VetChainAnimalOnboardingInput = Readonly<{
     birthYear?: number;
     gender?: 'female' | 'male' | 'other' | 'unknown';
     ncbiTaxonomyId: string;
+    breedLabel?: string;
     controllerEmail?: string;
     controllerTelephone?: string;
     sector?: string;
@@ -24,6 +25,7 @@ export type VetChainAnimalDraftInput = Readonly<{
     birthYear?: number;
     gender?: 'female' | 'male' | 'other' | 'unknown';
     ncbiTaxonomyId?: string;
+    breedLabel?: string;
     controllerEmail?: string;
     controllerTelephone?: string;
     sector?: string;
@@ -41,6 +43,7 @@ export declare const VetChainAnimalOnboardingClaimNames: Readonly<{
     readonly sameAs: "org.schema.Organization.sameAs";
     readonly memberName: "org.schema.Organization.member.name";
     readonly memberAdditionalType: "org.schema.Organization.member.additionalType";
+    readonly memberBreed: "org.schema.Organization.member.breed";
     readonly memberBirthDate: "org.schema.Organization.member.birthDate";
     readonly memberGender: "org.schema.Organization.member.gender";
     readonly memberRole: "org.schema.Organization.member.role";

package/dist/animal-onboarding.js

@@ -12,6 +12,7 @@ export const VetChainAnimalOnboardingClaimNames = Object.freeze({
     sameAs: 'org.schema.Organization.sameAs',
     memberName: 'org.schema.Organization.member.name',
     memberAdditionalType: 'org.schema.Organization.member.additionalType',
+    memberBreed: 'org.schema.Organization.member.breed',
     memberBirthDate: 'org.schema.Organization.member.birthDate',
     memberGender: 'org.schema.Organization.member.gender',
     memberRole: 'org.schema.Organization.member.role',
@@ -37,8 +38,9 @@ export function buildVetChainAnimalDraftClaims(input) {
         throw new TypeError('vet_animal_card_species_required');
     if (cardDidWeb)
         assertCardSpecies(cardDidWeb, ncbiTaxonomyId);
-    const birthDate = String(input.birthDate || '').trim()
-        || (Number.isInteger(input.birthYear) ? String(input.birthYear) : '');
+    const birthDate = normalizePartialBirthDate(String(input.birthDate || '').trim()
+        || (Number.isInteger(input.birthYear) ? String(input.birthYear) : ''));
+    const breedLabel = String(input.breedLabel || '').trim();
     const legalName = String(input.legalName || '').trim();
     const gender = input.gender && input.gender !== 'unknown' ? input.gender : '';
     const claim = VetChainAnimalOnboardingClaimNames;
@@ -55,6 +57,7 @@ export function buildVetChainAnimalDraftClaims(input) {
         ...(ncbiTaxonomyId ? {
             [claim.memberAdditionalType]: `http://purl.obolibrary.org/obo/NCBITaxon_${ncbiTaxonomyId}`,
         } : {}),
+        ...(breedLabel ? { [claim.memberBreed]: breedLabel } : {}),
         [claim.memberRole]: VetChainAnimalMemberRoles.Self,
         ...(birthDate ? { [claim.memberBirthDate]: birthDate } : {}),
         ...(gender ? { [claim.memberGender]: gender } : {}),
@@ -63,6 +66,26 @@ export function buildVetChainAnimalDraftClaims(input) {
         [claim.serviceCategory]: String(input.sector || '').trim() || 'animal-care',
     });
 }
+/** Normalizes ISO 8601 reduced-precision animal birth dates (year, year-month or full date). */
+function normalizePartialBirthDate(value) {
+    if (!value)
+        return '';
+    const match = value.match(/^(\d{4})(?:-(\d{2})(?:-(\d{2}))?)?$/);
+    if (!match)
+        throw new TypeError('vet_animal_birth_date_invalid');
+    const year = Number(match[1]);
+    const month = match[2] ? Number(match[2]) : undefined;
+    const day = match[3] ? Number(match[3]) : undefined;
+    if (year < 1000 || year > 9999 || (month !== undefined && (month < 1 || month > 12))) {
+        throw new TypeError('vet_animal_birth_date_invalid');
+    }
+    if (day !== undefined) {
+        const lastDay = new Date(Date.UTC(year, month, 0)).getUTCDate();
+        if (day < 1 || day > lastDay)
+            throw new TypeError('vet_animal_birth_date_invalid');
+    }
+    return value;
+}
 /** Reports whether an animal draft can be activated and issued a public Card. */
 export function readVetChainAnimalOnboardingReadiness(claims) {
     const claim = VetChainAnimalOnboardingClaimNames;

package/docs/101-ANIMAL-INDIVIDUAL-ONBOARDING.md

@@ -21,6 +21,16 @@ const draft = buildVetChainAnimalDraftClaims({
   controllerTelephone: '+12365162385',
 })
 
+// Optional breed text stays separate from the governed NCBI species. The
+// birth date may safely retain reduced year-month precision.
+buildVetChainAnimalDraftClaims({
+  subjectId: crypto.randomUUID(),
+  controllerTelephone: '+12365162385',
+  ncbiTaxonomyId: '9615',
+  breedLabel: 'Beagle',
+  birthDate: '2022-01',
+})
+
 // Step 2. The draft has member=SELF/ONESELF and owner=controller.
 draft['org.schema.Organization.member.role'] // ONESELF
 draft['org.schema.Organization.owner.telephone'] // verified controller
@@ -35,3 +45,10 @@ taxonomy, issues the public Card, and resubmits it under the same private
 `subjectId`. GW VET alone performs the `pending -> active` transition. A draft
 does not need a clinical `Composition`; the active clinical index is a
 separate document lifecycle.
+
+The controller is the author of demographics supplied during this draft. A
+veterinarian later verifies them as attester. That verification locks the
+controller-facing edit path; a correction is a new version authored and
+attested by an authorized veterinarian, never a rewrite of the earlier author.
+Veterinary identity evidence publishes only protected proof and lifecycle
+metadata to the ledger, not raw identity documents or private demographics.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-sdk-core-ts",
-  "version": "0.4.38",
+  "version": "0.4.39",
   "description": "Browser-safe VetChain core contracts and governed animal species identifiers",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",