vet-data-utils-ts 0.5.3 → 0.5.5

package/README.md

@@ -1,5 +1,8 @@
 # vet-data-utils-ts
 
+Development and releases follow the mandatory
+[`local-first TDD and release contract`](docs/LOCAL_FIRST_RELEASE_CONTRACT.md).
+
 Browser-safe, transport-neutral VetChain data contracts shared by GW VET and
 `vet-sdk-core-ts`. The package owns governed values and validation only; GW VET
 owns authorization and the SDK owns request construction.

package/dist/clinical-terminology.d.ts

@@ -19,6 +19,23 @@ export declare const VeterinaryTerminologySourceScopes: Readonly<{
     readonly Icd10: "ICD10";
     readonly AtcVet: "ATCVET";
 }>;
+/** Deterministic standards-based data for the isolated local terminology upstream. */
+export declare const VET_TERMINOLOGY_TEST_DATA: Readonly<{
+    readonly localApiKey: "local-playwright-umls-key";
+    readonly bodyTemperature: Readonly<{
+        source: "LNC";
+        system: "http://loinc.org";
+        code: "8310-5";
+        display: "Body temperature:Temp:Pt:^Patient:Qn";
+    }>;
+    readonly otitisExternaSpanish: Readonly<{
+        scope: "SNOMED_CT";
+        umlsSource: "SCTSPA";
+        system: "http://snomed.info/sct";
+        code: "3135009";
+        display: "otitis externa";
+    }>;
+}>;
 export type VeterinaryTerminologySourceScope = typeof VeterinaryTerminologySourceScopes[keyof typeof VeterinaryTerminologySourceScopes];
 export type VeterinaryTerminologyCapability = Readonly<{
     type: 'terminology-capability';

package/dist/clinical-terminology.js

@@ -19,6 +19,23 @@ export const VeterinaryTerminologySourceScopes = Object.freeze({
     Icd10: 'ICD10',
     AtcVet: 'ATCVET',
 });
+/** Deterministic standards-based data for the isolated local terminology upstream. */
+export const VET_TERMINOLOGY_TEST_DATA = Object.freeze({
+    localApiKey: 'local-playwright-umls-key',
+    bodyTemperature: Object.freeze({
+        source: VeterinaryTerminologySourceScopes.Loinc,
+        system: VeterinaryClinicalTerminologySystems.Loinc,
+        code: '8310-5',
+        display: 'Body temperature:Temp:Pt:^Patient:Qn',
+    }),
+    otitisExternaSpanish: Object.freeze({
+        scope: VeterinaryTerminologySourceScopes.SnomedCt,
+        umlsSource: 'SCTSPA',
+        system: VeterinaryClinicalTerminologySystems.SnomedCt,
+        code: '3135009',
+        display: 'otitis externa',
+    }),
+});
 /**
  * ISO 3166-1 alpha-2 territories enumerated by the official SNOMED
  * International member page on 2026-09-05.

package/dist/financial.d.ts

@@ -13,6 +13,48 @@ export declare const VeterinaryFinancialResourceTypes: Readonly<{
     readonly PaymentReconciliation: "PaymentReconciliation";
 }>;
 export type VeterinaryFinancialResourceType = typeof VeterinaryFinancialResourceTypes[keyof typeof VeterinaryFinancialResourceTypes];
+/** Governed FHIR R5 claim names used by payment reconciliation builders. */
+export declare const VeterinaryPaymentClaimNames: Readonly<{
+    readonly Invoice: Readonly<{
+        Identifier: "Invoice.identifier";
+        Status: "Invoice.status";
+        Recipient: "Invoice.recipient";
+        Creation: "Invoice.creation";
+        TotalGross: "Invoice.total-gross";
+    }>;
+    readonly PaymentNotice: Readonly<{
+        Identifier: "PaymentNotice.identifier";
+        Status: "PaymentNotice.status";
+        Request: "PaymentNotice.request";
+        Created: "PaymentNotice.created";
+        Payment: "PaymentNotice.payment";
+        PaymentDate: "PaymentNotice.payment-date";
+        Recipient: "PaymentNotice.recipient";
+        Amount: "PaymentNotice.amount";
+    }>;
+    readonly PaymentReconciliation: Readonly<{
+        Identifier: "PaymentReconciliation.identifier";
+        Type: "PaymentReconciliation.type";
+        Status: "PaymentReconciliation.status";
+        Created: "PaymentReconciliation.created";
+        Outcome: "PaymentReconciliation.outcome";
+        Date: "PaymentReconciliation.date";
+        ReferenceNumber: "PaymentReconciliation.reference-number";
+        Amount: "PaymentReconciliation.amount";
+        PaymentIdentifier: "PaymentReconciliation.payment-identifier";
+        AllocationTarget: "PaymentReconciliation.allocation-target";
+        AllocationAmount: "PaymentReconciliation.allocation-amount";
+    }>;
+}>;
+export declare const FhirR5FinancialStatusCodes: Readonly<{
+    readonly Active: "active";
+    readonly InvoiceIssued: "issued";
+    readonly ReconciliationComplete: "complete";
+}>;
+export declare const FhirR5PaymentType: Readonly<{
+    readonly system: "http://terminology.hl7.org/CodeSystem/payment-type";
+    readonly code: "payment";
+}>;
 /** Canonical claim allow-list used before a native FHIR resource is indexed. */
 export declare const VeterinaryFinancialClaimCatalog: Readonly<{
     Account: readonly ["Account.identifier", "Account.status", "Account.billing-status", "Account.type", "Account.name", "Account.subject", "Account.service-period", "Account.coverage-coverage", "Account.coverage-priority", "Account.owner", "Account.description", "Account.guarantor-party", "Account.guarantor-on-hold", "Account.guarantor-period", "Account.diagnosis-sequence", "Account.diagnosis-condition", "Account.diagnosis-date", "Account.diagnosis-type", "Account.diagnosis-on-admission", "Account.diagnosis-package-code", "Account.procedure-sequence", "Account.procedure-code", "Account.procedure-date-of-service", "Account.procedure-type", "Account.procedure-package-code", "Account.procedure-device", "Account.related-account-account", "Account.related-account-relationship", "Account.currency", "Account.balance-aggregate", "Account.balance-term", "Account.balance-estimate", "Account.balance-amount", "Account.calculated-at"];
@@ -24,3 +66,25 @@ export declare const VeterinaryFinancialClaimCatalog: Readonly<{
 export declare function getVeterinaryFinancialClaims(resourceType: unknown): readonly string[];
 /** Checks both the resource family and its claim prefix/allow-list. */
 export declare function isVeterinaryFinancialClaim(resourceType: unknown, claim: unknown): boolean;
+export type ClaimsFirstFinancialResource<T extends VeterinaryFinancialResourceType> = Readonly<{
+    resourceType: T;
+    id: string;
+    meta: Readonly<{
+        claims: Readonly<Record<string, unknown>>;
+    }>;
+}>;
+/**
+ * Projects verified provider evidence into standard FHIR R5 financial claims.
+ * Provider references use existing FHIR elements and never extend the catalog.
+ */
+export type EvmTransferFinancialReconciliation = Readonly<{
+    invoice: ClaimsFirstFinancialResource<'Invoice'>;
+    paymentNotice: ClaimsFirstFinancialResource<'PaymentNotice'>;
+    paymentReconciliation: ClaimsFirstFinancialResource<'PaymentReconciliation'>;
+}>;
+export declare function buildEvmTransferFinancialReconciliation(input: Readonly<{
+    quote: import('./payment.js').EvmTransferPaymentQuote;
+    transactionHash: `0x${string}`;
+    verifiedAt: string;
+    recipientReference: string;
+}>): EvmTransferFinancialReconciliation;

package/dist/financial.js

@@ -12,6 +12,33 @@ export const VeterinaryFinancialResourceTypes = Object.freeze({
     PaymentNotice: 'PaymentNotice',
     PaymentReconciliation: 'PaymentReconciliation',
 });
+/** Governed FHIR R5 claim names used by payment reconciliation builders. */
+export const VeterinaryPaymentClaimNames = Object.freeze({
+    Invoice: Object.freeze({
+        Identifier: 'Invoice.identifier', Status: 'Invoice.status', Recipient: 'Invoice.recipient',
+        Creation: 'Invoice.creation', TotalGross: 'Invoice.total-gross',
+    }),
+    PaymentNotice: Object.freeze({
+        Identifier: 'PaymentNotice.identifier', Status: 'PaymentNotice.status', Request: 'PaymentNotice.request',
+        Created: 'PaymentNotice.created', Payment: 'PaymentNotice.payment', PaymentDate: 'PaymentNotice.payment-date',
+        Recipient: 'PaymentNotice.recipient', Amount: 'PaymentNotice.amount',
+    }),
+    PaymentReconciliation: Object.freeze({
+        Identifier: 'PaymentReconciliation.identifier', Type: 'PaymentReconciliation.type',
+        Status: 'PaymentReconciliation.status', Created: 'PaymentReconciliation.created',
+        Outcome: 'PaymentReconciliation.outcome', Date: 'PaymentReconciliation.date',
+        ReferenceNumber: 'PaymentReconciliation.reference-number', Amount: 'PaymentReconciliation.amount',
+        PaymentIdentifier: 'PaymentReconciliation.payment-identifier',
+        AllocationTarget: 'PaymentReconciliation.allocation-target',
+        AllocationAmount: 'PaymentReconciliation.allocation-amount',
+    }),
+});
+export const FhirR5FinancialStatusCodes = Object.freeze({
+    Active: 'active', InvoiceIssued: 'issued', ReconciliationComplete: 'complete',
+});
+export const FhirR5PaymentType = Object.freeze({
+    system: 'http://terminology.hl7.org/CodeSystem/payment-type', code: 'payment',
+});
 const accountClaims = Object.freeze([
     'Account.identifier',
     'Account.status',
@@ -160,3 +187,59 @@ export function isVeterinaryFinancialClaim(resourceType, claim) {
 function isVeterinaryFinancialResourceType(value) {
     return Object.values(VeterinaryFinancialResourceTypes).includes(value);
 }
+function usdcMoney(amountMinor) {
+    const padded = amountMinor.padStart(7, '0');
+    const split = padded.length - 6;
+    return { value: `${padded.slice(0, split)}.${padded.slice(split)}`, currency: 'USD' };
+}
+export function buildEvmTransferFinancialReconciliation(input) {
+    const paymentNoticeId = input.quote.paymentReference;
+    const paymentReconciliationId = input.quote.paymentReference;
+    const invoiceReference = `Invoice/${input.quote.invoiceId}`;
+    const reconciliationReference = `PaymentReconciliation/${paymentReconciliationId}`;
+    const money = usdcMoney(input.quote.amountMinor);
+    return {
+        invoice: {
+            resourceType: VeterinaryFinancialResourceTypes.Invoice,
+            id: input.quote.invoiceId,
+            meta: { claims: {
+                    [VeterinaryPaymentClaimNames.Invoice.Identifier]: input.quote.paymentReference,
+                    [VeterinaryPaymentClaimNames.Invoice.Status]: FhirR5FinancialStatusCodes.InvoiceIssued,
+                    [VeterinaryPaymentClaimNames.Invoice.Recipient]: input.recipientReference,
+                    [VeterinaryPaymentClaimNames.Invoice.Creation]: input.quote.createdAt,
+                    [VeterinaryPaymentClaimNames.Invoice.TotalGross]: money,
+                } },
+        },
+        paymentNotice: {
+            resourceType: VeterinaryFinancialResourceTypes.PaymentNotice,
+            id: paymentNoticeId,
+            meta: { claims: {
+                    [VeterinaryPaymentClaimNames.PaymentNotice.Identifier]: input.quote.paymentReference,
+                    [VeterinaryPaymentClaimNames.PaymentNotice.Status]: FhirR5FinancialStatusCodes.Active,
+                    [VeterinaryPaymentClaimNames.PaymentNotice.Request]: invoiceReference,
+                    [VeterinaryPaymentClaimNames.PaymentNotice.Created]: input.verifiedAt,
+                    [VeterinaryPaymentClaimNames.PaymentNotice.Payment]: reconciliationReference,
+                    [VeterinaryPaymentClaimNames.PaymentNotice.PaymentDate]: input.verifiedAt.slice(0, 10),
+                    [VeterinaryPaymentClaimNames.PaymentNotice.Recipient]: input.recipientReference,
+                    [VeterinaryPaymentClaimNames.PaymentNotice.Amount]: money,
+                } },
+        },
+        paymentReconciliation: {
+            resourceType: VeterinaryFinancialResourceTypes.PaymentReconciliation,
+            id: paymentReconciliationId,
+            meta: { claims: {
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.Identifier]: input.quote.paymentReference,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.Type]: { coding: [FhirR5PaymentType] },
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.Status]: FhirR5FinancialStatusCodes.Active,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.Created]: input.verifiedAt,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.Outcome]: FhirR5FinancialStatusCodes.ReconciliationComplete,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.Date]: input.verifiedAt.slice(0, 10),
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.ReferenceNumber]: input.transactionHash,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.Amount]: money,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.PaymentIdentifier]: input.quote.paymentReference,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.AllocationTarget]: invoiceReference,
+                    [VeterinaryPaymentClaimNames.PaymentReconciliation.AllocationAmount]: money,
+                } },
+        },
+    };
+}

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './financial.js';
 export * from './group.js';
 export * from './iso-jurisdictions.js';
 export * from './organization-application.js';
+export * from './payment.js';
 export * from './research-study.js';
 export * from './sectors.js';
 export * from './veterinary-sections.js';

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './financial.js';
 export * from './group.js';
 export * from './iso-jurisdictions.js';
 export * from './organization-application.js';
+export * from './payment.js';
 export * from './research-study.js';
 export * from './sectors.js';
 export * from './veterinary-sections.js';

package/dist/payment.d.ts

@@ -0,0 +1,125 @@
+/** Provider and asset identifiers for VetChain payment adapters. */
+export declare const PaymentProviderIds: Readonly<{
+    readonly Stripe: "STRIPE";
+    readonly EvmTransfer: "EVM_TRANSFER";
+}>;
+export declare const PaymentAssetIds: Readonly<{
+    readonly Usdc: "USDC";
+}>;
+export declare const PaymentCurrencyCodes: Readonly<{
+    readonly Usd: "USD";
+}>;
+export declare const USDC_DECIMALS: 6;
+export declare const PaymentFlowActions: Readonly<{
+    readonly Quote: "quote";
+    readonly Confirm: "confirm";
+}>;
+export type PaymentFlowAction = typeof PaymentFlowActions[keyof typeof PaymentFlowActions];
+export type EvmTransferPaymentConfirmation = Readonly<{
+    offerId: string;
+    transactionHash: `0x${string}`;
+}>;
+export declare const EvmPaymentNetworkIds: Readonly<{
+    readonly LocalAnvil: "local-anvil";
+    readonly BaseSepolia: "base-sepolia";
+    readonly BaseMainnet: "base-mainnet";
+}>;
+export type PaymentProviderId = typeof PaymentProviderIds[keyof typeof PaymentProviderIds];
+export type EvmPaymentNetworkId = typeof EvmPaymentNetworkIds[keyof typeof EvmPaymentNetworkIds];
+export type EvmTransferNetwork = Readonly<{
+    id: EvmPaymentNetworkId;
+    chainId: number;
+    asset: typeof PaymentAssetIds.Usdc;
+    tokenContract: `0x${string}`;
+    mainnet: boolean;
+}>;
+/** Circle-issued native USDC contracts for Base. */
+export declare const USDC_BASE_NETWORKS: Readonly<{
+    "base-sepolia": Readonly<{
+        id: "base-sepolia";
+        chainId: 84532;
+        asset: "USDC";
+        tokenContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+        mainnet: false;
+    }>;
+    "base-mainnet": Readonly<{
+        id: "base-mainnet";
+        chainId: 8453;
+        asset: "USDC";
+        tokenContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        mainnet: true;
+    }>;
+}>;
+export type EvmTransferPaymentQuote = Readonly<{
+    version: 1;
+    provider: typeof PaymentProviderIds.EvmTransfer;
+    asset: typeof PaymentAssetIds.Usdc;
+    paymentReference: string;
+    invoiceId: string;
+    offerId: string;
+    network: EvmPaymentNetworkId;
+    chainId: number;
+    tokenContract: `0x${string}`;
+    recipient: `0x${string}`;
+    amountMinor: string;
+    decimals: typeof USDC_DECIMALS;
+    createdAt: string;
+    expiresAt: string;
+    expectedPayer?: `0x${string}`;
+}>;
+/** Reusable deterministic values for package, GW, BFF and browser tests. */
+export declare const VET_PAYMENT_TEST_DATA: Readonly<{
+    readonly recipient: "0x1111111111111111111111111111111111111111";
+    readonly otherRecipient: "0x2222222222222222222222222222222222222222";
+    readonly payer: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266";
+    readonly localPayerPrivateKey: "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80";
+    readonly localUsdcContract: "0x5FbDB2315678afecb367f032d93F642f64180aa3";
+    readonly localRpcUrl: "http://127.0.0.1:3270";
+    readonly transactionHash: `0x${string}`;
+    readonly otherTransactionHash: `0x${string}`;
+    readonly amountMinor: 10000000n;
+    readonly amountMinorText: "10000000";
+    readonly zeroPriceText: "0";
+    readonly invalidAmountMinorText: "10.5";
+    readonly invalidOfferPriceText: "10.0000001";
+    readonly decimals: 6;
+    readonly priceText: "10";
+    readonly currency: "USD";
+    readonly localChainId: 31337;
+    readonly receiptBlockNumber: 100n;
+    readonly confirmedBlockNumber: 102n;
+    readonly minimumConfirmations: 3;
+    readonly quantity: 1;
+    readonly localPurchaseQuantity: 3;
+    readonly paymentReference: "pay_test_01";
+    readonly invoiceId: "invoice_test_01";
+    readonly offerId: "offer_test_01";
+    readonly ownerId: "payment_owner_test_01";
+    readonly profileId: "payment_profile_test_01";
+    readonly recipientOrganizationReference: "Organization/payment-recipient-test";
+    readonly validAt: "2026-09-07T12:00:00.000Z";
+    readonly expiresAt: "2026-09-07T12:10:00.000Z";
+    readonly expiredAt: "2026-09-07T12:11:00.000Z";
+    readonly quote: Readonly<{
+        version: 1;
+        provider: "EVM_TRANSFER";
+        asset: "USDC";
+        paymentReference: string;
+        invoiceId: string;
+        offerId: string;
+        network: "local-anvil";
+        chainId: number;
+        tokenContract: "0x5FbDB2315678afecb367f032d93F642f64180aa3";
+        recipient: "0x1111111111111111111111111111111111111111";
+        amountMinor: string;
+        decimals: 6;
+        createdAt: string;
+        expiresAt: string;
+        expectedPayer: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266";
+    }>;
+}>;
+export declare function usdOfferToUsdcMinor(input: Readonly<{
+    price: unknown;
+    priceCurrency: unknown;
+    quantity: unknown;
+}>): bigint;

package/dist/payment.js

@@ -0,0 +1,104 @@
+/** Provider and asset identifiers for VetChain payment adapters. */
+export const PaymentProviderIds = Object.freeze({
+    Stripe: 'STRIPE',
+    EvmTransfer: 'EVM_TRANSFER',
+});
+export const PaymentAssetIds = Object.freeze({ Usdc: 'USDC' });
+export const PaymentCurrencyCodes = Object.freeze({ Usd: 'USD' });
+export const USDC_DECIMALS = 6;
+export const PaymentFlowActions = Object.freeze({
+    Quote: 'quote',
+    Confirm: 'confirm',
+});
+export const EvmPaymentNetworkIds = Object.freeze({
+    LocalAnvil: 'local-anvil',
+    BaseSepolia: 'base-sepolia',
+    BaseMainnet: 'base-mainnet',
+});
+/** Circle-issued native USDC contracts for Base. */
+export const USDC_BASE_NETWORKS = Object.freeze({
+    [EvmPaymentNetworkIds.BaseSepolia]: Object.freeze({
+        id: EvmPaymentNetworkIds.BaseSepolia,
+        chainId: 84532,
+        asset: PaymentAssetIds.Usdc,
+        tokenContract: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+        mainnet: false,
+    }),
+    [EvmPaymentNetworkIds.BaseMainnet]: Object.freeze({
+        id: EvmPaymentNetworkIds.BaseMainnet,
+        chainId: 8453,
+        asset: PaymentAssetIds.Usdc,
+        tokenContract: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        mainnet: true,
+    }),
+});
+/** Reusable deterministic values for package, GW, BFF and browser tests. */
+export const VET_PAYMENT_TEST_DATA = Object.freeze({
+    recipient: '0x1111111111111111111111111111111111111111',
+    otherRecipient: '0x2222222222222222222222222222222222222222',
+    payer: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
+    localPayerPrivateKey: '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80',
+    localUsdcContract: '0x5FbDB2315678afecb367f032d93F642f64180aa3',
+    localRpcUrl: 'http://127.0.0.1:3270',
+    transactionHash: `0x${'a'.repeat(64)}`,
+    otherTransactionHash: `0x${'b'.repeat(64)}`,
+    amountMinor: 10000000n,
+    amountMinorText: '10000000',
+    zeroPriceText: '0',
+    invalidAmountMinorText: '10.5',
+    invalidOfferPriceText: '10.0000001',
+    decimals: USDC_DECIMALS,
+    priceText: '10',
+    currency: PaymentCurrencyCodes.Usd,
+    localChainId: 31337,
+    receiptBlockNumber: 100n,
+    confirmedBlockNumber: 102n,
+    minimumConfirmations: 3,
+    quantity: 1,
+    localPurchaseQuantity: 3,
+    paymentReference: 'pay_test_01',
+    invoiceId: 'invoice_test_01',
+    offerId: 'offer_test_01',
+    ownerId: 'payment_owner_test_01',
+    profileId: 'payment_profile_test_01',
+    recipientOrganizationReference: 'Organization/payment-recipient-test',
+    validAt: '2026-09-07T12:00:00.000Z',
+    expiresAt: '2026-09-07T12:10:00.000Z',
+    expiredAt: '2026-09-07T12:11:00.000Z',
+    quote: Object.freeze({
+        version: 1,
+        provider: PaymentProviderIds.EvmTransfer,
+        asset: PaymentAssetIds.Usdc,
+        paymentReference: 'pay_test_01',
+        invoiceId: 'invoice_test_01',
+        offerId: 'offer_test_01',
+        network: EvmPaymentNetworkIds.LocalAnvil,
+        chainId: 31337,
+        tokenContract: '0x5FbDB2315678afecb367f032d93F642f64180aa3',
+        recipient: '0x1111111111111111111111111111111111111111',
+        amountMinor: '10000000',
+        decimals: USDC_DECIMALS,
+        createdAt: '2026-09-07T12:00:00.000Z',
+        expiresAt: '2026-09-07T12:10:00.000Z',
+        expectedPayer: '0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266',
+    }),
+});
+export function usdOfferToUsdcMinor(input) {
+    if (String(input.priceCurrency || '').trim().toUpperCase() !== PaymentCurrencyCodes.Usd) {
+        throw new Error('usdc_offer_currency_invalid');
+    }
+    const price = String(input.price || '').trim();
+    if (!/^(?:0|[1-9][0-9]*)(?:\.[0-9]{1,6})?$/.test(price)) {
+        throw new Error('usdc_offer_amount_invalid');
+    }
+    const quantity = Number(input.quantity);
+    if (!Number.isSafeInteger(quantity) || quantity < 1) {
+        throw new Error('usdc_offer_quantity_invalid');
+    }
+    const [whole, fraction = ''] = price.split('.');
+    const unitAmountMinor = BigInt(whole) * 1000000n + BigInt(fraction.padEnd(6, '0'));
+    if (unitAmountMinor <= 0n) {
+        throw new Error('usdc_offer_amount_invalid');
+    }
+    return unitAmountMinor * BigInt(quantity);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vet-data-utils-ts",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "Browser-safe governed VetChain data contracts",
   "license": "Apache-2.0",
   "author": "Connecting Solution & Applications Ltd",
@@ -48,6 +48,10 @@
       "types": "./dist/organization-application.d.ts",
       "default": "./dist/organization-application.js"
     },
+    "./payment": {
+      "types": "./dist/payment.d.ts",
+      "default": "./dist/payment.js"
+    },
     "./research-study": {
       "types": "./dist/research-study.d.ts",
       "default": "./dist/research-study.js"