vet-data-utils-ts 0.3.1 → 0.4.2

package/dist/iso-jurisdictions.d.ts

@@ -0,0 +1,16 @@
+export type Iso3166Country = Readonly<{
+    code: string;
+    name: string;
+}>;
+export type Iso3166Subdivision = Readonly<{
+    code: string;
+    countryCode: string;
+    name: string;
+    parentCode?: string;
+    type: string;
+}>;
+export declare const Iso3166Countries: readonly Iso3166Country[];
+export declare const Iso3166Subdivisions: readonly Iso3166Subdivision[];
+export declare function isIso3166CountryCode(value: string): boolean;
+export declare function iso3166SubdivisionsForCountry(countryCode: string): readonly Iso3166Subdivision[];
+export declare function isIso3166SubdivisionForCountry(subdivisionCode: string, countryCode: string): boolean;

package/dist/iso-jurisdictions.js

@@ -0,0 +1,28 @@
+import { Iso3166CountryData, Iso3166SubdivisionData } from './iso-jurisdictions-data.js';
+export const Iso3166Countries = Object.freeze(Iso3166CountryData.map(country => Object.freeze({ ...country })));
+export const Iso3166Subdivisions = Object.freeze(Iso3166SubdivisionData.map(subdivision => Object.freeze({ ...subdivision })));
+const countryCodes = new Set(Iso3166Countries.map(({ code }) => code));
+const mutableSubdivisionsByCountry = new Map();
+const subdivisionCodes = new Set();
+for (const subdivision of Iso3166Subdivisions) {
+    subdivisionCodes.add(subdivision.code);
+    const current = mutableSubdivisionsByCountry.get(subdivision.countryCode) ?? [];
+    current.push(subdivision);
+    mutableSubdivisionsByCountry.set(subdivision.countryCode, current);
+}
+const subdivisionsByCountry = new Map([...mutableSubdivisionsByCountry].map(([countryCode, subdivisions]) => [
+    countryCode,
+    Object.freeze(subdivisions),
+]));
+export function isIso3166CountryCode(value) {
+    return countryCodes.has(value);
+}
+export function iso3166SubdivisionsForCountry(countryCode) {
+    if (!isIso3166CountryCode(countryCode))
+        return [];
+    return subdivisionsByCountry.get(countryCode) ?? [];
+}
+export function isIso3166SubdivisionForCountry(subdivisionCode, countryCode) {
+    return subdivisionCode.startsWith(`${countryCode}-`)
+        && subdivisionCodes.has(subdivisionCode);
+}

package/dist/organization-application.d.ts

@@ -0,0 +1,44 @@
+export declare const OrganizationOfficialIdTypes: Readonly<{
+    readonly Tax: "TAX";
+    readonly EmployerIdentificationNumber: "EIN";
+    readonly BusinessNumber: "BN";
+}>;
+export declare const OrganizationParticipationRoles: Readonly<{
+    readonly IndividualIndexServiceProvider: "individual-index-service-provider";
+    readonly IndividualIndexDataProvider: "individual-index-data-provider";
+    readonly IndividualIndexDataConsumer: "individual-index-data-consumer";
+    readonly DigitalTwinIndexServiceProvider: "digital-twin-index-service-provider";
+    readonly DigitalTwinDataProvider: "digital-twin-data-provider";
+    readonly DigitalTwinDataConsumer: "digital-twin-data-consumer";
+}>;
+export type OrganizationOfficialIdType = typeof OrganizationOfficialIdTypes[keyof typeof OrganizationOfficialIdTypes];
+export type OrganizationParticipationRole = typeof OrganizationParticipationRoles[keyof typeof OrganizationParticipationRoles];
+export type ReusableOrganizationApplication = Readonly<{
+    sector: string;
+    officialId: Readonly<{
+        type: OrganizationOfficialIdType;
+        value: string;
+    }>;
+    countryCode: string;
+    regionalId: boolean;
+    subdivisionCode?: string;
+    officialLicense?: string;
+    legalRepresentative: Readonly<{
+        name: string;
+        email: string;
+    }>;
+    technicalController: Readonly<{
+        email: string;
+        sameAsLegalRepresentative: boolean;
+    }>;
+    participationRoles: readonly OrganizationParticipationRole[];
+}>;
+/**
+ * Validates only reusable organization-application business data.
+ *
+ * Product adapters supply the sector allowlist and translated labels. Login,
+ * PIN/passkey protection, PDF rendering, delivery, activation-code exchange,
+ * DCR, wallet keys and gateway routing are deliberately outside this value
+ * object and remain inside the BFF/high-level Node runtime.
+ */
+export declare function parseReusableOrganizationApplication(input: unknown): ReusableOrganizationApplication;

package/dist/organization-application.js

@@ -0,0 +1,105 @@
+import { isIso3166CountryCode, isIso3166SubdivisionForCountry } from './iso-jurisdictions.js';
+export const OrganizationOfficialIdTypes = Object.freeze({
+    Tax: 'TAX',
+    EmployerIdentificationNumber: 'EIN',
+    BusinessNumber: 'BN',
+});
+export const OrganizationParticipationRoles = Object.freeze({
+    IndividualIndexServiceProvider: 'individual-index-service-provider',
+    IndividualIndexDataProvider: 'individual-index-data-provider',
+    IndividualIndexDataConsumer: 'individual-index-data-consumer',
+    DigitalTwinIndexServiceProvider: 'digital-twin-index-service-provider',
+    DigitalTwinDataProvider: 'digital-twin-data-provider',
+    DigitalTwinDataConsumer: 'digital-twin-data-consumer',
+});
+const officialIdTypes = new Set(Object.values(OrganizationOfficialIdTypes));
+const participationRoles = new Set(Object.values(OrganizationParticipationRoles));
+/**
+ * Validates only reusable organization-application business data.
+ *
+ * Product adapters supply the sector allowlist and translated labels. Login,
+ * PIN/passkey protection, PDF rendering, delivery, activation-code exchange,
+ * DCR, wallet keys and gateway routing are deliberately outside this value
+ * object and remain inside the BFF/high-level Node runtime.
+ */
+export function parseReusableOrganizationApplication(input) {
+    const value = record(input, 'organization_application_invalid');
+    forbid(value, ['taxId', 'profilePin', 'newProfilePin', 'repeatProfilePin']);
+    const allowedSectors = strings(value.allowedSectors);
+    const sector = required(value.sector, 'organization_sector_required');
+    if (!allowedSectors.includes(sector))
+        throw new TypeError('organization_sector_not_allowed');
+    const officialId = record(value.officialId, 'organization_official_id_required');
+    const officialIdType = required(officialId.type, 'organization_official_id_type_required');
+    if (!officialIdTypes.has(officialIdType))
+        throw new TypeError('organization_official_id_type_invalid');
+    const countryCode = required(value.countryCode, 'organization_country_required').toUpperCase();
+    if (!isIso3166CountryCode(countryCode))
+        throw new TypeError('organization_country_invalid');
+    const regionalId = value.regionalId === true;
+    const subdivisionCode = optional(value.subdivisionCode)?.toUpperCase();
+    if (regionalId && (!subdivisionCode || !isIso3166SubdivisionForCountry(subdivisionCode, countryCode))) {
+        throw new TypeError('organization_subdivision_invalid');
+    }
+    if (!regionalId && subdivisionCode)
+        throw new TypeError('organization_subdivision_without_regional_id');
+    const legalRepresentative = record(value.legalRepresentative, 'organization_legal_representative_required');
+    const legalEmail = email(legalRepresentative.email, 'organization_legal_representative_email_required');
+    const technicalController = record(value.technicalController, 'organization_technical_controller_required');
+    const sameAsLegalRepresentative = technicalController.sameAsLegalRepresentative === true;
+    const technicalEmail = sameAsLegalRepresentative
+        ? legalEmail
+        : email(technicalController.email, 'organization_technical_controller_email_required');
+    const selectedRoles = strings(value.participationRoles);
+    if (selectedRoles.some(role => !participationRoles.has(role))) {
+        throw new TypeError('organization_participation_role_invalid');
+    }
+    return Object.freeze({
+        sector,
+        officialId: Object.freeze({
+            type: officialIdType,
+            value: required(officialId.value, 'organization_official_id_value_required'),
+        }),
+        countryCode,
+        regionalId,
+        ...(subdivisionCode ? { subdivisionCode } : {}),
+        ...(optional(value.officialLicense) ? { officialLicense: optional(value.officialLicense) } : {}),
+        legalRepresentative: Object.freeze({
+            name: required(legalRepresentative.name, 'organization_legal_representative_name_required'),
+            email: legalEmail,
+        }),
+        technicalController: Object.freeze({ email: technicalEmail, sameAsLegalRepresentative }),
+        participationRoles: Object.freeze([...new Set(selectedRoles)]),
+    });
+}
+function record(value, error) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new TypeError(error);
+    return value;
+}
+function strings(value) {
+    return Array.isArray(value) ? value.map(item => String(item).trim()).filter(Boolean) : [];
+}
+function required(value, error) {
+    const normalized = String(value ?? '').trim();
+    if (!normalized)
+        throw new TypeError(error);
+    return normalized;
+}
+function optional(value) {
+    const normalized = String(value ?? '').trim();
+    return normalized || undefined;
+}
+function email(value, error) {
+    const normalized = required(value, error).toLowerCase();
+    if (!/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(normalized))
+        throw new TypeError(error);
+    return normalized;
+}
+function forbid(value, names) {
+    for (const name of names) {
+        if (Object.prototype.hasOwnProperty.call(value, name)) {
+            throw new TypeError(name === 'taxId' ? 'organization_tax_id_forbidden' : 'organization_profile_pin_forbidden');
+        }
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-data-utils-ts",
-  "version": "0.3.1",
+  "version": "0.4.2",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -8,22 +8,62 @@
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
-    ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
-    "./animal-card": { "types": "./dist/animal-card.d.ts", "default": "./dist/animal-card.js" },
-    "./digital-twin": { "types": "./dist/digital-twin.d.ts", "default": "./dist/digital-twin.js" },
-    "./emergency": { "types": "./dist/emergency.d.ts", "default": "./dist/emergency.js" },
-    "./veterinary-sections": { "types": "./dist/veterinary-sections.d.ts", "default": "./dist/veterinary-sections.js" },
-    "./assistant": { "types": "./dist/assistant.d.ts", "default": "./dist/assistant.js" }
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./animal-card": {
+      "types": "./dist/animal-card.d.ts",
+      "default": "./dist/animal-card.js"
+    },
+    "./digital-twin": {
+      "types": "./dist/digital-twin.d.ts",
+      "default": "./dist/digital-twin.js"
+    },
+    "./emergency": {
+      "types": "./dist/emergency.d.ts",
+      "default": "./dist/emergency.js"
+    },
+    "./financial": {
+      "types": "./dist/financial.d.ts",
+      "default": "./dist/financial.js"
+    },
+    "./iso-jurisdictions": {
+      "types": "./dist/iso-jurisdictions.d.ts",
+      "default": "./dist/iso-jurisdictions.js"
+    },
+    "./organization-application": {
+      "types": "./dist/organization-application.d.ts",
+      "default": "./dist/organization-application.js"
+    },
+    "./veterinary-sections": {
+      "types": "./dist/veterinary-sections.d.ts",
+      "default": "./dist/veterinary-sections.js"
+    },
+    "./assistant": {
+      "types": "./dist/assistant.d.ts",
+      "default": "./dist/assistant.js"
+    }
   },
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "build": "npm run clean && tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "npm run build && node --test tests/*.test.mjs",
+    "update:iso-jurisdictions": "node scripts/update-iso-jurisdictions.mjs",
     "prepare": "npm run build",
     "prepublishOnly": "npm run typecheck && npm test"
   },
-  "devDependencies": { "@types/node": "^22.0.0", "typescript": "^5.5.4" },
-  "engines": { "node": ">=20" }
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.4"
+  },
+  "engines": {
+    "node": ">=20"
+  }
 }