vet-data-utils-ts 0.5.3 → 0.5.4

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/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,96 @@
+/** Provider and asset identifiers for VetChain payment adapters. */
+export declare const PaymentProviderIds: Readonly<{
+    readonly Stripe: "STRIPE";
+    readonly UsdcEvm: "USDC_EVM";
+}>;
+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 UsdcPaymentConfirmation = 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 UsdcEvmNetwork = Readonly<{
+    id: EvmPaymentNetworkId;
+    chainId: number;
+    usdcContract: `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;
+        usdcContract: "0x036CbD53842c5426634e7929541eC2318f3dCF7e";
+        mainnet: false;
+    }>;
+    "base-mainnet": Readonly<{
+        id: "base-mainnet";
+        chainId: 8453;
+        usdcContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        mainnet: true;
+    }>;
+}>;
+export type UsdcPaymentQuote = Readonly<{
+    version: 1;
+    provider: typeof PaymentProviderIds.UsdcEvm;
+    paymentReference: string;
+    invoiceId: string;
+    network: EvmPaymentNetworkId;
+    chainId: number;
+    tokenContract: `0x${string}`;
+    recipient: `0x${string}`;
+    amountMinor: string;
+    decimals: typeof USDC_DECIMALS;
+    expiresAt: 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 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 validAt: "2026-09-07T12:00:00.000Z";
+    readonly expiresAt: "2026-09-07T12:10:00.000Z";
+    readonly expiredAt: "2026-09-07T12:11:00.000Z";
+}>;
+export declare function usdOfferToUsdcMinor(input: Readonly<{
+    price: unknown;
+    priceCurrency: unknown;
+    quantity: unknown;
+}>): bigint;

package/dist/payment.js

@@ -0,0 +1,80 @@
+/** Provider and asset identifiers for VetChain payment adapters. */
+export const PaymentProviderIds = Object.freeze({
+    Stripe: 'STRIPE',
+    UsdcEvm: 'USDC_EVM',
+});
+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,
+        usdcContract: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+        mainnet: false,
+    }),
+    [EvmPaymentNetworkIds.BaseMainnet]: Object.freeze({
+        id: EvmPaymentNetworkIds.BaseMainnet,
+        chainId: 8453,
+        usdcContract: '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)}`,
+    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',
+    validAt: '2026-09-07T12:00:00.000Z',
+    expiresAt: '2026-09-07T12:10:00.000Z',
+    expiredAt: '2026-09-07T12:11:00.000Z',
+});
+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.4",
   "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"