@vivoa/plugin-sdk 0.6.8 → 0.6.9

package/dist/{host-api-BbIT_sLc.d.mts → host-api-Eeb42fR2.d.mts}

@@ -442,6 +442,8 @@ interface PaymentCard {
 interface PaymentCustomer {
     email: string;
     phone: string;
+    /** OPTIONAL full name of the payer, for gateways that display or require it. */
+    name?: string;
     address?: string;
     city?: string;
     state?: string;
@@ -478,6 +480,23 @@ interface PaymentResult {
  * - `embed`           gateway-owned iframe initialised via `createPaymentSession`.
  */
 type PaymentRenderMode = 'card-in' | 'offsite-redirect' | 'embed';
+/**
+ * Fee model a gateway charges the MERCHANT, declared statically so the host can
+ * project the fee before any charge exists (checkout preview, settlement
+ * breakdown). The fee is computed on the GROSS amount charged to the shopper.
+ */
+interface GatewayFeeConfig {
+    /** Default merchant rate as a FRACTION of the gross (0.038 === 3.8%). */
+    defaultRate: number;
+    /** True when the rate already includes tax (IVA): no tax is added on top. */
+    ivaInclusive: boolean;
+    /**
+     * Where the rate comes from. `reported`: the gateway reports the effective
+     * rate per charge (webhook / pricing endpoint), so `defaultRate` is only a
+     * fallback. `contract`: a fixed contractual rate the gateway never reports.
+     */
+    source: 'reported' | 'contract';
+}
 interface GatewayStaticConfig {
     code: PaymentGatewayCode;
     displayName: string;
@@ -490,6 +509,16 @@ interface GatewayStaticConfig {
      * Back-compat: existing card-in plugins (Wompi/Serfinsa) omit this field.
      */
     renderMode?: PaymentRenderMode;
+    /**
+     * OPTIONAL merchant fee model (see {@link GatewayFeeConfig}). Absent ⇒ the host
+     * assumes the gateway fee is unknown and shows no fee projection.
+     */
+    fees?: GatewayFeeConfig;
+    /**
+     * OPTIONAL ISO-4217 currencies the gateway can charge. Absent ⇒ the host does
+     * not restrict by currency.
+     */
+    supportedCurrencies?: string[];
 }
 /**
  * Cardless payload for creating a gateway-hosted payment session (INV-1).
@@ -532,6 +561,70 @@ interface PaymentSessionResult {
     renderMode: PaymentRenderMode;
     embedInit?: EmbedInit;
     redirectUrl?: string;
+    /**
+     * OPTIONAL merchant-fee PREVIEW the gateway computed when sealing the
+     * session. Informational: the settled fee arrives with the webhook
+     * ({@link PaymentWebhookSettlement.fees}).
+     */
+    fees?: PaymentSessionFees;
+}
+/**
+ * Merchant-fee preview attached to a created payment session. Amounts are in
+ * DECIMAL major units of `currency`; `rate` is a FRACTION.
+ */
+interface PaymentSessionFees {
+    rate: number;
+    /** Free-form origin of the rate (e.g. `merchant`, `default`). */
+    rateSource?: string;
+    feeAmount: number;
+    netAmount: number;
+    currency: string;
+}
+/**
+ * Fee breakdown a gateway reports for a SETTLED charge. `feeAmount` is taken on
+ * the gross `amount`; `netAmount = amount - feeAmount`. Amounts are DECIMAL
+ * major units of `currency`; `rate` is a FRACTION.
+ */
+interface PaymentSettlementFees {
+    feeAmount: number;
+    rate: number;
+    netAmount: number;
+    /** True when `feeAmount` already includes tax (IVA). */
+    ivaIncluded: boolean;
+    currency: string;
+}
+/**
+ * Final outcome of a charge as read from a gateway webhook, normalised by the
+ * plugin so the host settles every gateway through one path. Only terminal
+ * outcomes are expressed: intermediate events are not settlements.
+ */
+interface PaymentWebhookSettlement {
+    /** Merchant reference the charge was created with (host correlation key). */
+    reference: string;
+    status: 'approved' | 'declined';
+    /** Gross amount charged, DECIMAL major units of `currency`. */
+    amount: number;
+    currency: string;
+    gatewayTransactionId: string;
+    /** Gateway-side transaction id, when distinct from `gatewayTransactionId`. */
+    transactionId?: string;
+    /** Gateway event id, stable across redeliveries (idempotency key). */
+    eventId?: string;
+    authorizationCode?: string;
+    /** Merchant fee breakdown, only when the gateway reports it. */
+    fees?: PaymentSettlementFees;
+}
+/**
+ * Merchant-specific pricing a gateway exposes, so the host can refresh its
+ * cached fee projection. `rate` is a FRACTION of the gross charged.
+ */
+interface PaymentMerchantPricing {
+    rate: number;
+    /** Free-form origin of the rate (e.g. `merchant`, `default`). */
+    rateSource: string;
+    /** Free-form fee model identifier (e.g. `flat_gross_iva_included`). */
+    model: string;
+    currency: string;
 }
 interface PaymentPluginConfig {
     configSchema: PluginConfigField[];
@@ -582,6 +675,20 @@ interface IPaymentPlugin extends IPlugin {
     verifyTransaction?(payload: PaymentVerifyPayload, ctx: DispatchContext): Promise<PaymentResult>;
     validateWebhookSignature?(rawBody: string | Buffer, headers: Record<string, string>, ctx: DispatchContext): WebhookSignatureResult;
     processWebhook?(payload: unknown, ctx: DispatchContext): Promise<void>;
+    /**
+     * Normalise a webhook payload into a {@link PaymentWebhookSettlement}.
+     * OPTIONAL — a plugin that omits it keeps the host's legacy webhook parsing.
+     * Called by the host only AFTER `validateWebhookSignature` passed. PURE and
+     * synchronous: no I/O, no state. Throw on a payload that cannot be read as a
+     * terminal charge outcome; the host validates whatever it returns.
+     */
+    parseWebhookSettlement?(payload: unknown, ctx: DispatchContext): PaymentWebhookSettlement;
+    /**
+     * Merchant-specific pricing for the account in `ctx.config`. OPTIONAL — used
+     * by the host to refresh its cached fee projection. Resolve `null` when the
+     * gateway exposes no per-merchant pricing or it is unavailable right now.
+     */
+    getMerchantPricing?(ctx: DispatchContext): Promise<PaymentMerchantPricing | null>;
     /**
      * Query the gateway for the current status of a previously attempted charge.
      * Called by the host when `processPayment` returns `status: Error` with a
@@ -706,6 +813,32 @@ interface CreateShipmentParams {
     courierId?: string;
     serviceLevelToken?: string;
 }
+/**
+ * How the carrier moves money on a shipment:
+ * - `normal`  → nothing collected; the merchant is billed the shipping.
+ * - `cod`     → the carrier collects from the recipient and settles to the merchant.
+ * - `collect` → the recipient pays only the shipping; nothing settles to the merchant.
+ */
+type CarrierServiceMode = 'normal' | 'cod' | 'collect';
+/**
+ * What the carrier ACTUALLY settles for a shipment, in the order currency —
+ * the carrier's truth, which the host shows next to what it quoted. Each
+ * shipping plugin translates its own provider fields into this; the host never
+ * reads `rawResponse`.
+ */
+interface CarrierSettlement {
+    mode: CarrierServiceMode;
+    /** Cash the carrier collects from the recipient. */
+    collected: number;
+    /** Commission the carrier charges the merchant for collecting. */
+    commission: number;
+    /** That commission as a percent of `collected` (3 = 3%), when known. */
+    commissionRate?: number;
+    /** Shipping deducted from the settlement (0 when billed apart). */
+    shippingDeducted: number;
+    /** What the merchant receives for this shipment. */
+    merchantNet: number;
+}
 interface ShipmentResult {
     externalId: string;
     trackingNumber: string;
@@ -715,6 +848,8 @@ interface ShipmentResult {
     courierName: string;
     status: string;
     rawResponse?: Record<string, unknown>;
+    /** The carrier's settlement, when the provider reports it at creation. */
+    settlement?: CarrierSettlement;
 }
 /**
  * Normalized, carrier-agnostic shipment status event produced by
@@ -792,9 +927,16 @@ interface SuppliersStaticConfig {
 }
 interface SupplierCatalogQuery {
     text?: string;
+    /** ISO-3166-1 alpha-2. A driver that cannot serve it returns an empty page. */
     country?: string;
     cursor?: string;
     limit?: number;
+    /** Wholesale price floor, minor units (inclusive). */
+    minPriceMinor?: number;
+    /** Wholesale price ceiling, minor units (inclusive). */
+    maxPriceMinor?: number;
+    /** Only listings the supplier reports as in stock. */
+    inStockOnly?: boolean;
 }
 interface SupplierListingVariant {
     externalVariantId: string;
@@ -833,12 +975,16 @@ interface SupplierListing {
     hasVariants: boolean;
     variants?: SupplierListingVariant[];
     moq?: number | null;
+    /** Display name of the vendor behind the listing (a marketplace may host many). */
+    vendorName?: string | null;
     /** Untouched supplier payload, for diagnostics. Never trusted for control flow. */
     raw?: unknown;
 }
 interface SupplierListingPage {
     items: SupplierListing[];
     nextCursor?: string | null;
+    /** Total listings matching the query across all pages, when the supplier reports it. */
+    total?: number | null;
 }
 interface SupplierOrderCustomer {
     name: string;
@@ -952,11 +1098,19 @@ declare enum AnalyticsFeature {
 /**
  * ISO-4217 money in minor units — mirrors the store's Money VO so the host maps
  * 1:1 without a currency guess. Kept local so the SDK stays dependency-free.
+ * The exponent is the currency's own (USD 2, CLP/JPY 0, KWD 3): encode with
+ * {@link toMinorUnits}, decode with {@link toMajorUnits}, never a fixed ×100.
  */
 interface AnalyticsMoney {
     amountMinor: number;
     currency: string;
 }
+/** ISO-4217 minor-unit exponent (USD 2, JPY 0, KWD 3); unknown → 2. */
+declare function minorUnitDigits(currency: string): number;
+/** A major-unit amount (e.g. `25.5` USD) as {@link AnalyticsMoney}. */
+declare function toMinorUnits(major: number, currency: string): AnalyticsMoney;
+/** The major-unit decimal of {@link AnalyticsMoney} (e.g. `2550` USD → `25.5`). */
+declare function toMajorUnits(money: AnalyticsMoney): number;
 /** A single line item attached to an ecommerce event. */
 interface AnalyticsItem {
     /** Product id as the store knows it (Meta `content_ids`, GA4 `item_id`). */
@@ -976,7 +1130,25 @@ interface AnalyticsItem {
  * only ever maps a domain event to one of these. An adapter that does not care
  * about a given name simply ignores it.
  */
-type AnalyticsEventName = 'page_view' | 'view_item' | 'add_to_cart' | 'remove_from_cart' | 'begin_checkout' | 'purchase';
+type AnalyticsEventName = 'page_view' | 'view_item' | 'add_to_cart' | 'remove_from_cart' | 'begin_checkout' | 'purchase' | 'order_placed';
+/**
+ * When a cash-on-delivery order counts as a `purchase` for an adapter:
+ *   - `collected` — when the cash is collected (carrier delivery or staff
+ *     marking it paid). Highest signal quality; the default.
+ *   - `confirmed` — when staff confirms the order (e.g. after a confirmation
+ *     call). Faster learning and inside the ad platform's dedup/attribution
+ *     windows, at the cost of counting confirmed orders the shopper refuses.
+ * Prepaid orders always convert when the gateway approves the payment.
+ */
+type CodPurchaseTrigger = 'collected' | 'confirmed';
+/**
+ * Per-store settlement policy the HOST reads from an analytics adapter's own
+ * config (`DispatchContext.config`). An adapter opts in by declaring a config
+ * field with this exact key; one that declares none gets the defaults.
+ */
+interface AnalyticsPurchasePolicy {
+    codPurchaseTrigger?: CodPurchaseTrigger;
+}
 /**
  * Where the action physically happened. Maps to Meta `action_source`; other
  * providers ignore it. Defaults to `website` when the host omits it.
@@ -1004,7 +1176,11 @@ interface AnalyticsUserData {
     genderSha256?: string | null;
     /** Date of birth, YYYYMMDD normalized then SHA256. */
     dobSha256?: string | null;
-    /** Store customer/user id — Meta `external_id` (not hashed by spec). */
+    /**
+     * Pseudonymous shopper id (user, else guest) — Meta `external_id`. Arrives
+     * PLAIN: it is not PII. An adapter whose provider wants it hashed (Meta, to
+     * meet the browser pixel) hashes it itself.
+     */
     externalId?: string | null;
     /** Plain IPv4/IPv6 — never hashed (geo match). */
     clientIpAddress?: string | null;
@@ -1566,4 +1742,4 @@ interface HostApi {
     registerCapability<T = unknown>(cap: Capability<T>): void;
 }
 
-export { type HttpClient as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type ConditionalBlock as D, type ConditionalEquals as E, FieldType as F, type ConditionalWhen as G, type ConfigurablePlugin as H, ContentActionVariant as I, type ContentBlock as J, ContentBlockType as K, type CopyFieldBlock$1 as L, type CreateShipmentParams as M, type DispatchContext as N, type DividerBlock$1 as O, type PluginConfigField as P, type DomainEventHandler as Q, type DomainEventName as R, type SelectOption as S, type EmbedInit as T, type FieldBlock as U, type FieldOption as V, FieldVariant as W, GatewayEnvironment as X, type GatewayStaticConfig as Y, type GroupBlock as Z, type HostApi as _, type AccordionBlock as a, type ShippingQuote as a$, type HttpRequest as a0, type HttpResponse as a1, type IAnalyticsPlugin as a2, type IInvoicingPlugin as a3, type IPaymentPlugin as a4, type IPlugin as a5, type IShippingPlugin as a6, type ISuppliersPlugin as a7, type IUiPlugin as a8, type InlineRowBlock as a9, type PaymentRenderMode as aA, type PaymentResult as aB, type PaymentSessionPayload as aC, type PaymentSessionResult as aD, type PaymentVerifyPayload as aE, type PlaceSupplierOrderInput as aF, type Plugin as aG, type PluginActionContext as aH, type PluginActionResult as aI, type PluginAuthor as aJ, type PluginConfigFieldDependency as aK, type PluginFactory as aL, type PluginManifest as aM, type RepeaterBlock as aN, RepeaterSource as aO, type SecretStore as aP, type SequenceStore as aQ, type SetupAction as aR, type SetupLayout as aS, type SetupLayoutValidation as aT, type SetupStep as aU, type ShipmentAddress as aV, type ShipmentParcel as aW, type ShipmentResult as aX, type ShippingDefaultConfig as aY, ShippingFeature as aZ, type ShippingPluginConfig as a_, InvoiceDocumentType as aa, type InvoiceLine as ab, type InvoiceMoney as ac, type InvoiceParty as ad, type InvoiceRequest as ae, type InvoiceResult as af, InvoiceStatus as ag, type InvoiceTax as ah, type InvoicingDefaultConfig as ai, InvoicingFeature as aj, type InvoicingPluginConfig as ak, type InvoicingStaticConfig as al, type KeyValueBlock$1 as am, type KeyValueRow$1 as an, LayoutMode as ao, type Logger as ap, type MarkdownBlock as aq, MessageVariant as ar, type PaymentCard as as, type PaymentConnect as at, type PaymentConnectExchange as au, type PaymentConnectParams as av, type PaymentCustomer as aw, type PaymentGatewayCode as ax, type PaymentPayload as ay, type PaymentPluginConfig as az, type AccordionSection as b, type ShippingQuoteParams as b0, type ShippingStaticConfig as b1, StepStatusFrom as b2, type StepStatusFromAction as b3, type StepStatusFromFields as b4, type StepStatusSource as b5, type StorageBroker as b6, type SupplierCatalogQuery as b7, type SupplierFulfillmentEvent as b8, type SupplierListing as b9, crossValidateSetupLayout as bA, definePlugin as bB, invoicingCapability as bC, isConfigurablePlugin as bD, isPluginFactory as bE, paymentCapability as bF, shippingCapability as bG, suppliersCapability as bH, uiCapability as bI, validatePluginAuthor as bJ, validateSetupLayout as bK, validateUiContributions as bL, type SupplierListingAttribute as ba, type SupplierListingPage as bb, type SupplierListingVariant as bc, type SupplierMoney as bd, type SupplierOrderAddressLevel as be, type SupplierOrderCustomer as bf, type SupplierOrderLine as bg, type SupplierOrderResult as bh, type SupplierOrderStatus as bi, type SupplierShipTo as bj, type SupplierStock as bk, type SuppliersDefaultConfig as bl, SuppliersFeature as bm, type SuppliersPluginConfig as bn, type SuppliersStaticConfig as bo, type TabItem as bp, type TabsBlock as bq, type ToggleBlock as br, type TrackingEvent as bs, TransactionStatus as bt, type UiContribution as bu, type UiContributionsValidation as bv, type VoidInvoiceInput as bw, type WebhookSignatureResult as bx, analyticsCapability as by, capability as bz, type ActionBlock$1 as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsStaticConfig as m, type AnalyticsUserData as n, type AnalyticsUtm as o, type AuthorValidation as p, type Block as q, type BlockBase as r, BlockType as s, type CalloutBlock as t, type Capability as u, CapabilityKind as v, type CardBlock$1 as w, type CodConfig as x, type CodFeeConfig as y, CodFeeType as z };
+export { GatewayEnvironment as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CodConfig as D, type CodFeeConfig as E, FieldType as F, CodFeeType as G, type CodPurchaseTrigger as H, type ConditionalBlock as I, type ConditionalEquals as J, type ConditionalWhen as K, type ConfigurablePlugin as L, ContentActionVariant as M, type ContentBlock as N, ContentBlockType as O, type PluginConfigField as P, type CopyFieldBlock$1 as Q, type CreateShipmentParams as R, type SelectOption as S, type DispatchContext as T, type DividerBlock$1 as U, type DomainEventHandler as V, type DomainEventName as W, type EmbedInit as X, type FieldBlock as Y, type FieldOption as Z, FieldVariant as _, type AccordionBlock as a, type SetupLayout as a$, type GatewayFeeConfig as a0, type GatewayStaticConfig as a1, type GroupBlock as a2, type HostApi as a3, type HttpClient as a4, type HttpRequest as a5, type HttpResponse as a6, type IAnalyticsPlugin as a7, type IInvoicingPlugin as a8, type IPaymentPlugin as a9, type PaymentConnectParams as aA, type PaymentCustomer as aB, type PaymentGatewayCode as aC, type PaymentMerchantPricing as aD, type PaymentPayload as aE, type PaymentPluginConfig as aF, type PaymentRenderMode as aG, type PaymentResult as aH, type PaymentSessionFees as aI, type PaymentSessionPayload as aJ, type PaymentSessionResult as aK, type PaymentSettlementFees as aL, type PaymentVerifyPayload as aM, type PaymentWebhookSettlement as aN, type PlaceSupplierOrderInput as aO, type Plugin as aP, type PluginActionContext as aQ, type PluginActionResult as aR, type PluginAuthor as aS, type PluginConfigFieldDependency as aT, type PluginFactory as aU, type PluginManifest as aV, type RepeaterBlock as aW, RepeaterSource as aX, type SecretStore as aY, type SequenceStore as aZ, type SetupAction as a_, type IPlugin as aa, type IShippingPlugin as ab, type ISuppliersPlugin as ac, type IUiPlugin as ad, type InlineRowBlock as ae, InvoiceDocumentType as af, type InvoiceLine as ag, type InvoiceMoney as ah, type InvoiceParty as ai, type InvoiceRequest as aj, type InvoiceResult as ak, InvoiceStatus as al, type InvoiceTax as am, type InvoicingDefaultConfig as an, InvoicingFeature as ao, type InvoicingPluginConfig as ap, type InvoicingStaticConfig as aq, type KeyValueBlock$1 as ar, type KeyValueRow$1 as as, LayoutMode as at, type Logger as au, type MarkdownBlock as av, MessageVariant as aw, type PaymentCard as ax, type PaymentConnect as ay, type PaymentConnectExchange as az, type AccordionSection as b, type SetupLayoutValidation as b0, type SetupStep as b1, type ShipmentAddress as b2, type ShipmentParcel as b3, type ShipmentResult as b4, type ShippingDefaultConfig as b5, ShippingFeature as b6, type ShippingPluginConfig as b7, type ShippingQuote as b8, type ShippingQuoteParams as b9, type ToggleBlock as bA, type TrackingEvent as bB, TransactionStatus as bC, type UiContribution as bD, type UiContributionsValidation as bE, type VoidInvoiceInput as bF, type WebhookSignatureResult as bG, analyticsCapability as bH, capability as bI, crossValidateSetupLayout as bJ, definePlugin as bK, invoicingCapability as bL, isConfigurablePlugin as bM, isPluginFactory as bN, minorUnitDigits as bO, paymentCapability as bP, shippingCapability as bQ, suppliersCapability as bR, toMajorUnits as bS, toMinorUnits as bT, uiCapability as bU, validatePluginAuthor as bV, validateSetupLayout as bW, validateUiContributions as bX, type ShippingStaticConfig as ba, StepStatusFrom as bb, type StepStatusFromAction as bc, type StepStatusFromFields as bd, type StepStatusSource as be, type StorageBroker as bf, type SupplierCatalogQuery as bg, type SupplierFulfillmentEvent as bh, type SupplierListing as bi, type SupplierListingAttribute as bj, type SupplierListingPage as bk, type SupplierListingVariant as bl, type SupplierMoney as bm, type SupplierOrderAddressLevel as bn, type SupplierOrderCustomer as bo, type SupplierOrderLine as bp, type SupplierOrderResult as bq, type SupplierOrderStatus as br, type SupplierShipTo as bs, type SupplierStock as bt, type SuppliersDefaultConfig as bu, SuppliersFeature as bv, type SuppliersPluginConfig as bw, type SuppliersStaticConfig as bx, type TabItem as by, type TabsBlock as bz, type ActionBlock$1 as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsPurchasePolicy as m, type AnalyticsStaticConfig as n, type AnalyticsUserData as o, type AnalyticsUtm as p, type AuthorValidation as q, type Block as r, type BlockBase as s, BlockType as t, type CalloutBlock as u, type Capability as v, CapabilityKind as w, type CardBlock$1 as x, type CarrierServiceMode as y, type CarrierSettlement as z };

package/dist/{host-api-BbIT_sLc.d.ts → host-api-Eeb42fR2.d.ts}

@@ -442,6 +442,8 @@ interface PaymentCard {
 interface PaymentCustomer {
     email: string;
     phone: string;
+    /** OPTIONAL full name of the payer, for gateways that display or require it. */
+    name?: string;
     address?: string;
     city?: string;
     state?: string;
@@ -478,6 +480,23 @@ interface PaymentResult {
  * - `embed`           gateway-owned iframe initialised via `createPaymentSession`.
  */
 type PaymentRenderMode = 'card-in' | 'offsite-redirect' | 'embed';
+/**
+ * Fee model a gateway charges the MERCHANT, declared statically so the host can
+ * project the fee before any charge exists (checkout preview, settlement
+ * breakdown). The fee is computed on the GROSS amount charged to the shopper.
+ */
+interface GatewayFeeConfig {
+    /** Default merchant rate as a FRACTION of the gross (0.038 === 3.8%). */
+    defaultRate: number;
+    /** True when the rate already includes tax (IVA): no tax is added on top. */
+    ivaInclusive: boolean;
+    /**
+     * Where the rate comes from. `reported`: the gateway reports the effective
+     * rate per charge (webhook / pricing endpoint), so `defaultRate` is only a
+     * fallback. `contract`: a fixed contractual rate the gateway never reports.
+     */
+    source: 'reported' | 'contract';
+}
 interface GatewayStaticConfig {
     code: PaymentGatewayCode;
     displayName: string;
@@ -490,6 +509,16 @@ interface GatewayStaticConfig {
      * Back-compat: existing card-in plugins (Wompi/Serfinsa) omit this field.
      */
     renderMode?: PaymentRenderMode;
+    /**
+     * OPTIONAL merchant fee model (see {@link GatewayFeeConfig}). Absent ⇒ the host
+     * assumes the gateway fee is unknown and shows no fee projection.
+     */
+    fees?: GatewayFeeConfig;
+    /**
+     * OPTIONAL ISO-4217 currencies the gateway can charge. Absent ⇒ the host does
+     * not restrict by currency.
+     */
+    supportedCurrencies?: string[];
 }
 /**
  * Cardless payload for creating a gateway-hosted payment session (INV-1).
@@ -532,6 +561,70 @@ interface PaymentSessionResult {
     renderMode: PaymentRenderMode;
     embedInit?: EmbedInit;
     redirectUrl?: string;
+    /**
+     * OPTIONAL merchant-fee PREVIEW the gateway computed when sealing the
+     * session. Informational: the settled fee arrives with the webhook
+     * ({@link PaymentWebhookSettlement.fees}).
+     */
+    fees?: PaymentSessionFees;
+}
+/**
+ * Merchant-fee preview attached to a created payment session. Amounts are in
+ * DECIMAL major units of `currency`; `rate` is a FRACTION.
+ */
+interface PaymentSessionFees {
+    rate: number;
+    /** Free-form origin of the rate (e.g. `merchant`, `default`). */
+    rateSource?: string;
+    feeAmount: number;
+    netAmount: number;
+    currency: string;
+}
+/**
+ * Fee breakdown a gateway reports for a SETTLED charge. `feeAmount` is taken on
+ * the gross `amount`; `netAmount = amount - feeAmount`. Amounts are DECIMAL
+ * major units of `currency`; `rate` is a FRACTION.
+ */
+interface PaymentSettlementFees {
+    feeAmount: number;
+    rate: number;
+    netAmount: number;
+    /** True when `feeAmount` already includes tax (IVA). */
+    ivaIncluded: boolean;
+    currency: string;
+}
+/**
+ * Final outcome of a charge as read from a gateway webhook, normalised by the
+ * plugin so the host settles every gateway through one path. Only terminal
+ * outcomes are expressed: intermediate events are not settlements.
+ */
+interface PaymentWebhookSettlement {
+    /** Merchant reference the charge was created with (host correlation key). */
+    reference: string;
+    status: 'approved' | 'declined';
+    /** Gross amount charged, DECIMAL major units of `currency`. */
+    amount: number;
+    currency: string;
+    gatewayTransactionId: string;
+    /** Gateway-side transaction id, when distinct from `gatewayTransactionId`. */
+    transactionId?: string;
+    /** Gateway event id, stable across redeliveries (idempotency key). */
+    eventId?: string;
+    authorizationCode?: string;
+    /** Merchant fee breakdown, only when the gateway reports it. */
+    fees?: PaymentSettlementFees;
+}
+/**
+ * Merchant-specific pricing a gateway exposes, so the host can refresh its
+ * cached fee projection. `rate` is a FRACTION of the gross charged.
+ */
+interface PaymentMerchantPricing {
+    rate: number;
+    /** Free-form origin of the rate (e.g. `merchant`, `default`). */
+    rateSource: string;
+    /** Free-form fee model identifier (e.g. `flat_gross_iva_included`). */
+    model: string;
+    currency: string;
 }
 interface PaymentPluginConfig {
     configSchema: PluginConfigField[];
@@ -582,6 +675,20 @@ interface IPaymentPlugin extends IPlugin {
     verifyTransaction?(payload: PaymentVerifyPayload, ctx: DispatchContext): Promise<PaymentResult>;
     validateWebhookSignature?(rawBody: string | Buffer, headers: Record<string, string>, ctx: DispatchContext): WebhookSignatureResult;
     processWebhook?(payload: unknown, ctx: DispatchContext): Promise<void>;
+    /**
+     * Normalise a webhook payload into a {@link PaymentWebhookSettlement}.
+     * OPTIONAL — a plugin that omits it keeps the host's legacy webhook parsing.
+     * Called by the host only AFTER `validateWebhookSignature` passed. PURE and
+     * synchronous: no I/O, no state. Throw on a payload that cannot be read as a
+     * terminal charge outcome; the host validates whatever it returns.
+     */
+    parseWebhookSettlement?(payload: unknown, ctx: DispatchContext): PaymentWebhookSettlement;
+    /**
+     * Merchant-specific pricing for the account in `ctx.config`. OPTIONAL — used
+     * by the host to refresh its cached fee projection. Resolve `null` when the
+     * gateway exposes no per-merchant pricing or it is unavailable right now.
+     */
+    getMerchantPricing?(ctx: DispatchContext): Promise<PaymentMerchantPricing | null>;
     /**
      * Query the gateway for the current status of a previously attempted charge.
      * Called by the host when `processPayment` returns `status: Error` with a
@@ -706,6 +813,32 @@ interface CreateShipmentParams {
     courierId?: string;
     serviceLevelToken?: string;
 }
+/**
+ * How the carrier moves money on a shipment:
+ * - `normal`  → nothing collected; the merchant is billed the shipping.
+ * - `cod`     → the carrier collects from the recipient and settles to the merchant.
+ * - `collect` → the recipient pays only the shipping; nothing settles to the merchant.
+ */
+type CarrierServiceMode = 'normal' | 'cod' | 'collect';
+/**
+ * What the carrier ACTUALLY settles for a shipment, in the order currency —
+ * the carrier's truth, which the host shows next to what it quoted. Each
+ * shipping plugin translates its own provider fields into this; the host never
+ * reads `rawResponse`.
+ */
+interface CarrierSettlement {
+    mode: CarrierServiceMode;
+    /** Cash the carrier collects from the recipient. */
+    collected: number;
+    /** Commission the carrier charges the merchant for collecting. */
+    commission: number;
+    /** That commission as a percent of `collected` (3 = 3%), when known. */
+    commissionRate?: number;
+    /** Shipping deducted from the settlement (0 when billed apart). */
+    shippingDeducted: number;
+    /** What the merchant receives for this shipment. */
+    merchantNet: number;
+}
 interface ShipmentResult {
     externalId: string;
     trackingNumber: string;
@@ -715,6 +848,8 @@ interface ShipmentResult {
     courierName: string;
     status: string;
     rawResponse?: Record<string, unknown>;
+    /** The carrier's settlement, when the provider reports it at creation. */
+    settlement?: CarrierSettlement;
 }
 /**
  * Normalized, carrier-agnostic shipment status event produced by
@@ -792,9 +927,16 @@ interface SuppliersStaticConfig {
 }
 interface SupplierCatalogQuery {
     text?: string;
+    /** ISO-3166-1 alpha-2. A driver that cannot serve it returns an empty page. */
     country?: string;
     cursor?: string;
     limit?: number;
+    /** Wholesale price floor, minor units (inclusive). */
+    minPriceMinor?: number;
+    /** Wholesale price ceiling, minor units (inclusive). */
+    maxPriceMinor?: number;
+    /** Only listings the supplier reports as in stock. */
+    inStockOnly?: boolean;
 }
 interface SupplierListingVariant {
     externalVariantId: string;
@@ -833,12 +975,16 @@ interface SupplierListing {
     hasVariants: boolean;
     variants?: SupplierListingVariant[];
     moq?: number | null;
+    /** Display name of the vendor behind the listing (a marketplace may host many). */
+    vendorName?: string | null;
     /** Untouched supplier payload, for diagnostics. Never trusted for control flow. */
     raw?: unknown;
 }
 interface SupplierListingPage {
     items: SupplierListing[];
     nextCursor?: string | null;
+    /** Total listings matching the query across all pages, when the supplier reports it. */
+    total?: number | null;
 }
 interface SupplierOrderCustomer {
     name: string;
@@ -952,11 +1098,19 @@ declare enum AnalyticsFeature {
 /**
  * ISO-4217 money in minor units — mirrors the store's Money VO so the host maps
  * 1:1 without a currency guess. Kept local so the SDK stays dependency-free.
+ * The exponent is the currency's own (USD 2, CLP/JPY 0, KWD 3): encode with
+ * {@link toMinorUnits}, decode with {@link toMajorUnits}, never a fixed ×100.
  */
 interface AnalyticsMoney {
     amountMinor: number;
     currency: string;
 }
+/** ISO-4217 minor-unit exponent (USD 2, JPY 0, KWD 3); unknown → 2. */
+declare function minorUnitDigits(currency: string): number;
+/** A major-unit amount (e.g. `25.5` USD) as {@link AnalyticsMoney}. */
+declare function toMinorUnits(major: number, currency: string): AnalyticsMoney;
+/** The major-unit decimal of {@link AnalyticsMoney} (e.g. `2550` USD → `25.5`). */
+declare function toMajorUnits(money: AnalyticsMoney): number;
 /** A single line item attached to an ecommerce event. */
 interface AnalyticsItem {
     /** Product id as the store knows it (Meta `content_ids`, GA4 `item_id`). */
@@ -976,7 +1130,25 @@ interface AnalyticsItem {
  * only ever maps a domain event to one of these. An adapter that does not care
  * about a given name simply ignores it.
  */
-type AnalyticsEventName = 'page_view' | 'view_item' | 'add_to_cart' | 'remove_from_cart' | 'begin_checkout' | 'purchase';
+type AnalyticsEventName = 'page_view' | 'view_item' | 'add_to_cart' | 'remove_from_cart' | 'begin_checkout' | 'purchase' | 'order_placed';
+/**
+ * When a cash-on-delivery order counts as a `purchase` for an adapter:
+ *   - `collected` — when the cash is collected (carrier delivery or staff
+ *     marking it paid). Highest signal quality; the default.
+ *   - `confirmed` — when staff confirms the order (e.g. after a confirmation
+ *     call). Faster learning and inside the ad platform's dedup/attribution
+ *     windows, at the cost of counting confirmed orders the shopper refuses.
+ * Prepaid orders always convert when the gateway approves the payment.
+ */
+type CodPurchaseTrigger = 'collected' | 'confirmed';
+/**
+ * Per-store settlement policy the HOST reads from an analytics adapter's own
+ * config (`DispatchContext.config`). An adapter opts in by declaring a config
+ * field with this exact key; one that declares none gets the defaults.
+ */
+interface AnalyticsPurchasePolicy {
+    codPurchaseTrigger?: CodPurchaseTrigger;
+}
 /**
  * Where the action physically happened. Maps to Meta `action_source`; other
  * providers ignore it. Defaults to `website` when the host omits it.
@@ -1004,7 +1176,11 @@ interface AnalyticsUserData {
     genderSha256?: string | null;
     /** Date of birth, YYYYMMDD normalized then SHA256. */
     dobSha256?: string | null;
-    /** Store customer/user id — Meta `external_id` (not hashed by spec). */
+    /**
+     * Pseudonymous shopper id (user, else guest) — Meta `external_id`. Arrives
+     * PLAIN: it is not PII. An adapter whose provider wants it hashed (Meta, to
+     * meet the browser pixel) hashes it itself.
+     */
     externalId?: string | null;
     /** Plain IPv4/IPv6 — never hashed (geo match). */
     clientIpAddress?: string | null;
@@ -1566,4 +1742,4 @@ interface HostApi {
     registerCapability<T = unknown>(cap: Capability<T>): void;
 }
 
-export { type HttpClient as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type ConditionalBlock as D, type ConditionalEquals as E, FieldType as F, type ConditionalWhen as G, type ConfigurablePlugin as H, ContentActionVariant as I, type ContentBlock as J, ContentBlockType as K, type CopyFieldBlock$1 as L, type CreateShipmentParams as M, type DispatchContext as N, type DividerBlock$1 as O, type PluginConfigField as P, type DomainEventHandler as Q, type DomainEventName as R, type SelectOption as S, type EmbedInit as T, type FieldBlock as U, type FieldOption as V, FieldVariant as W, GatewayEnvironment as X, type GatewayStaticConfig as Y, type GroupBlock as Z, type HostApi as _, type AccordionBlock as a, type ShippingQuote as a$, type HttpRequest as a0, type HttpResponse as a1, type IAnalyticsPlugin as a2, type IInvoicingPlugin as a3, type IPaymentPlugin as a4, type IPlugin as a5, type IShippingPlugin as a6, type ISuppliersPlugin as a7, type IUiPlugin as a8, type InlineRowBlock as a9, type PaymentRenderMode as aA, type PaymentResult as aB, type PaymentSessionPayload as aC, type PaymentSessionResult as aD, type PaymentVerifyPayload as aE, type PlaceSupplierOrderInput as aF, type Plugin as aG, type PluginActionContext as aH, type PluginActionResult as aI, type PluginAuthor as aJ, type PluginConfigFieldDependency as aK, type PluginFactory as aL, type PluginManifest as aM, type RepeaterBlock as aN, RepeaterSource as aO, type SecretStore as aP, type SequenceStore as aQ, type SetupAction as aR, type SetupLayout as aS, type SetupLayoutValidation as aT, type SetupStep as aU, type ShipmentAddress as aV, type ShipmentParcel as aW, type ShipmentResult as aX, type ShippingDefaultConfig as aY, ShippingFeature as aZ, type ShippingPluginConfig as a_, InvoiceDocumentType as aa, type InvoiceLine as ab, type InvoiceMoney as ac, type InvoiceParty as ad, type InvoiceRequest as ae, type InvoiceResult as af, InvoiceStatus as ag, type InvoiceTax as ah, type InvoicingDefaultConfig as ai, InvoicingFeature as aj, type InvoicingPluginConfig as ak, type InvoicingStaticConfig as al, type KeyValueBlock$1 as am, type KeyValueRow$1 as an, LayoutMode as ao, type Logger as ap, type MarkdownBlock as aq, MessageVariant as ar, type PaymentCard as as, type PaymentConnect as at, type PaymentConnectExchange as au, type PaymentConnectParams as av, type PaymentCustomer as aw, type PaymentGatewayCode as ax, type PaymentPayload as ay, type PaymentPluginConfig as az, type AccordionSection as b, type ShippingQuoteParams as b0, type ShippingStaticConfig as b1, StepStatusFrom as b2, type StepStatusFromAction as b3, type StepStatusFromFields as b4, type StepStatusSource as b5, type StorageBroker as b6, type SupplierCatalogQuery as b7, type SupplierFulfillmentEvent as b8, type SupplierListing as b9, crossValidateSetupLayout as bA, definePlugin as bB, invoicingCapability as bC, isConfigurablePlugin as bD, isPluginFactory as bE, paymentCapability as bF, shippingCapability as bG, suppliersCapability as bH, uiCapability as bI, validatePluginAuthor as bJ, validateSetupLayout as bK, validateUiContributions as bL, type SupplierListingAttribute as ba, type SupplierListingPage as bb, type SupplierListingVariant as bc, type SupplierMoney as bd, type SupplierOrderAddressLevel as be, type SupplierOrderCustomer as bf, type SupplierOrderLine as bg, type SupplierOrderResult as bh, type SupplierOrderStatus as bi, type SupplierShipTo as bj, type SupplierStock as bk, type SuppliersDefaultConfig as bl, SuppliersFeature as bm, type SuppliersPluginConfig as bn, type SuppliersStaticConfig as bo, type TabItem as bp, type TabsBlock as bq, type ToggleBlock as br, type TrackingEvent as bs, TransactionStatus as bt, type UiContribution as bu, type UiContributionsValidation as bv, type VoidInvoiceInput as bw, type WebhookSignatureResult as bx, analyticsCapability as by, capability as bz, type ActionBlock$1 as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsStaticConfig as m, type AnalyticsUserData as n, type AnalyticsUtm as o, type AuthorValidation as p, type Block as q, type BlockBase as r, BlockType as s, type CalloutBlock as t, type Capability as u, CapabilityKind as v, type CardBlock$1 as w, type CodConfig as x, type CodFeeConfig as y, CodFeeType as z };
+export { GatewayEnvironment as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CodConfig as D, type CodFeeConfig as E, FieldType as F, CodFeeType as G, type CodPurchaseTrigger as H, type ConditionalBlock as I, type ConditionalEquals as J, type ConditionalWhen as K, type ConfigurablePlugin as L, ContentActionVariant as M, type ContentBlock as N, ContentBlockType as O, type PluginConfigField as P, type CopyFieldBlock$1 as Q, type CreateShipmentParams as R, type SelectOption as S, type DispatchContext as T, type DividerBlock$1 as U, type DomainEventHandler as V, type DomainEventName as W, type EmbedInit as X, type FieldBlock as Y, type FieldOption as Z, FieldVariant as _, type AccordionBlock as a, type SetupLayout as a$, type GatewayFeeConfig as a0, type GatewayStaticConfig as a1, type GroupBlock as a2, type HostApi as a3, type HttpClient as a4, type HttpRequest as a5, type HttpResponse as a6, type IAnalyticsPlugin as a7, type IInvoicingPlugin as a8, type IPaymentPlugin as a9, type PaymentConnectParams as aA, type PaymentCustomer as aB, type PaymentGatewayCode as aC, type PaymentMerchantPricing as aD, type PaymentPayload as aE, type PaymentPluginConfig as aF, type PaymentRenderMode as aG, type PaymentResult as aH, type PaymentSessionFees as aI, type PaymentSessionPayload as aJ, type PaymentSessionResult as aK, type PaymentSettlementFees as aL, type PaymentVerifyPayload as aM, type PaymentWebhookSettlement as aN, type PlaceSupplierOrderInput as aO, type Plugin as aP, type PluginActionContext as aQ, type PluginActionResult as aR, type PluginAuthor as aS, type PluginConfigFieldDependency as aT, type PluginFactory as aU, type PluginManifest as aV, type RepeaterBlock as aW, RepeaterSource as aX, type SecretStore as aY, type SequenceStore as aZ, type SetupAction as a_, type IPlugin as aa, type IShippingPlugin as ab, type ISuppliersPlugin as ac, type IUiPlugin as ad, type InlineRowBlock as ae, InvoiceDocumentType as af, type InvoiceLine as ag, type InvoiceMoney as ah, type InvoiceParty as ai, type InvoiceRequest as aj, type InvoiceResult as ak, InvoiceStatus as al, type InvoiceTax as am, type InvoicingDefaultConfig as an, InvoicingFeature as ao, type InvoicingPluginConfig as ap, type InvoicingStaticConfig as aq, type KeyValueBlock$1 as ar, type KeyValueRow$1 as as, LayoutMode as at, type Logger as au, type MarkdownBlock as av, MessageVariant as aw, type PaymentCard as ax, type PaymentConnect as ay, type PaymentConnectExchange as az, type AccordionSection as b, type SetupLayoutValidation as b0, type SetupStep as b1, type ShipmentAddress as b2, type ShipmentParcel as b3, type ShipmentResult as b4, type ShippingDefaultConfig as b5, ShippingFeature as b6, type ShippingPluginConfig as b7, type ShippingQuote as b8, type ShippingQuoteParams as b9, type ToggleBlock as bA, type TrackingEvent as bB, TransactionStatus as bC, type UiContribution as bD, type UiContributionsValidation as bE, type VoidInvoiceInput as bF, type WebhookSignatureResult as bG, analyticsCapability as bH, capability as bI, crossValidateSetupLayout as bJ, definePlugin as bK, invoicingCapability as bL, isConfigurablePlugin as bM, isPluginFactory as bN, minorUnitDigits as bO, paymentCapability as bP, shippingCapability as bQ, suppliersCapability as bR, toMajorUnits as bS, toMinorUnits as bT, uiCapability as bU, validatePluginAuthor as bV, validateSetupLayout as bW, validateUiContributions as bX, type ShippingStaticConfig as ba, StepStatusFrom as bb, type StepStatusFromAction as bc, type StepStatusFromFields as bd, type StepStatusSource as be, type StorageBroker as bf, type SupplierCatalogQuery as bg, type SupplierFulfillmentEvent as bh, type SupplierListing as bi, type SupplierListingAttribute as bj, type SupplierListingPage as bk, type SupplierListingVariant as bl, type SupplierMoney as bm, type SupplierOrderAddressLevel as bn, type SupplierOrderCustomer as bo, type SupplierOrderLine as bp, type SupplierOrderResult as bq, type SupplierOrderStatus as br, type SupplierShipTo as bs, type SupplierStock as bt, type SuppliersDefaultConfig as bu, SuppliersFeature as bv, type SuppliersPluginConfig as bw, type SuppliersStaticConfig as bx, type TabItem as by, type TabsBlock as bz, type ActionBlock$1 as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsPurchasePolicy as m, type AnalyticsStaticConfig as n, type AnalyticsUserData as o, type AnalyticsUtm as p, type AuthorValidation as q, type Block as r, type BlockBase as s, BlockType as t, type CalloutBlock as u, type Capability as v, CapabilityKind as w, type CardBlock$1 as x, type CarrierServiceMode as y, type CarrierSettlement as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-BbIT_sLc.mjs';
-export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsStaticConfig, n as AnalyticsUserData, o as AnalyticsUtm, p as AuthorValidation, B as BannerBlock, q as Block, r as BlockBase, s as BlockType, t as CalloutBlock, u as Capability, v as CapabilityKind, w as CardBlock, x as CodConfig, y as CodFeeConfig, z as CodFeeType, D as ConditionalBlock, E as ConditionalEquals, G as ConditionalWhen, H as ConfigurablePlugin, I as ContentActionVariant, J as ContentBlock, K as ContentBlockType, L as CopyFieldBlock, M as CreateShipmentParams, N as DispatchContext, O as DividerBlock, Q as DomainEventHandler, R as DomainEventName, T as EmbedInit, U as FieldBlock, V as FieldOption, W as FieldVariant, X as GatewayEnvironment, Y as GatewayStaticConfig, Z as GroupBlock, _ as HostApi, $ as HttpClient, a0 as HttpRequest, a1 as HttpResponse, a2 as IAnalyticsPlugin, a3 as IInvoicingPlugin, a4 as IPaymentPlugin, a5 as IPlugin, a6 as IShippingPlugin, a7 as ISuppliersPlugin, a8 as IUiPlugin, a9 as InlineRowBlock, aa as InvoiceDocumentType, ab as InvoiceLine, ac as InvoiceMoney, ad as InvoiceParty, ae as InvoiceRequest, af as InvoiceResult, ag as InvoiceStatus, ah as InvoiceTax, ai as InvoicingDefaultConfig, aj as InvoicingFeature, ak as InvoicingPluginConfig, al as InvoicingStaticConfig, am as KeyValueBlock, an as KeyValueRow, ao as LayoutMode, ap as Logger, aq as MarkdownBlock, ar as MessageVariant, as as PaymentCard, at as PaymentConnect, au as PaymentConnectExchange, av as PaymentConnectParams, aw as PaymentCustomer, ax as PaymentGatewayCode, ay as PaymentPayload, az as PaymentPluginConfig, aA as PaymentRenderMode, aB as PaymentResult, aC as PaymentSessionPayload, aD as PaymentSessionResult, aE as PaymentVerifyPayload, aF as PlaceSupplierOrderInput, aG as Plugin, aH as PluginActionContext, aI as PluginActionResult, aJ as PluginAuthor, aK as PluginConfigFieldDependency, aL as PluginFactory, aM as PluginManifest, aN as RepeaterBlock, aO as RepeaterSource, aP as SecretStore, aQ as SequenceStore, aR as SetupAction, aS as SetupLayout, aT as SetupLayoutValidation, aU as SetupStep, aV as ShipmentAddress, aW as ShipmentParcel, aX as ShipmentResult, aY as ShippingDefaultConfig, aZ as ShippingFeature, a_ as ShippingPluginConfig, a$ as ShippingQuote, b0 as ShippingQuoteParams, b1 as ShippingStaticConfig, b2 as StepStatusFrom, b3 as StepStatusFromAction, b4 as StepStatusFromFields, b5 as StepStatusSource, b6 as StorageBroker, b7 as SupplierCatalogQuery, b8 as SupplierFulfillmentEvent, b9 as SupplierListing, ba as SupplierListingAttribute, bb as SupplierListingPage, bc as SupplierListingVariant, bd as SupplierMoney, be as SupplierOrderAddressLevel, bf as SupplierOrderCustomer, bg as SupplierOrderLine, bh as SupplierOrderResult, bi as SupplierOrderStatus, bj as SupplierShipTo, bk as SupplierStock, bl as SuppliersDefaultConfig, bm as SuppliersFeature, bn as SuppliersPluginConfig, bo as SuppliersStaticConfig, bp as TabItem, bq as TabsBlock, br as ToggleBlock, bs as TrackingEvent, bt as TransactionStatus, bu as UiContribution, bv as UiContributionsValidation, bw as VoidInvoiceInput, bx as WebhookSignatureResult, by as analyticsCapability, bz as capability, bA as crossValidateSetupLayout, bB as definePlugin, bC as invoicingCapability, bD as isConfigurablePlugin, bE as isPluginFactory, bF as paymentCapability, bG as shippingCapability, bH as suppliersCapability, bI as uiCapability, bJ as validatePluginAuthor, bK as validateSetupLayout, bL as validateUiContributions } from './host-api-BbIT_sLc.mjs';
+import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-Eeb42fR2.mjs';
+export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsPurchasePolicy, n as AnalyticsStaticConfig, o as AnalyticsUserData, p as AnalyticsUtm, q as AuthorValidation, B as BannerBlock, r as Block, s as BlockBase, t as BlockType, u as CalloutBlock, v as Capability, w as CapabilityKind, x as CardBlock, y as CarrierServiceMode, z as CarrierSettlement, D as CodConfig, E as CodFeeConfig, G as CodFeeType, H as CodPurchaseTrigger, I as ConditionalBlock, J as ConditionalEquals, K as ConditionalWhen, L as ConfigurablePlugin, M as ContentActionVariant, N as ContentBlock, O as ContentBlockType, Q as CopyFieldBlock, R as CreateShipmentParams, T as DispatchContext, U as DividerBlock, V as DomainEventHandler, W as DomainEventName, X as EmbedInit, Y as FieldBlock, Z as FieldOption, _ as FieldVariant, $ as GatewayEnvironment, a0 as GatewayFeeConfig, a1 as GatewayStaticConfig, a2 as GroupBlock, a3 as HostApi, a4 as HttpClient, a5 as HttpRequest, a6 as HttpResponse, a7 as IAnalyticsPlugin, a8 as IInvoicingPlugin, a9 as IPaymentPlugin, aa as IPlugin, ab as IShippingPlugin, ac as ISuppliersPlugin, ad as IUiPlugin, ae as InlineRowBlock, af as InvoiceDocumentType, ag as InvoiceLine, ah as InvoiceMoney, ai as InvoiceParty, aj as InvoiceRequest, ak as InvoiceResult, al as InvoiceStatus, am as InvoiceTax, an as InvoicingDefaultConfig, ao as InvoicingFeature, ap as InvoicingPluginConfig, aq as InvoicingStaticConfig, ar as KeyValueBlock, as as KeyValueRow, at as LayoutMode, au as Logger, av as MarkdownBlock, aw as MessageVariant, ax as PaymentCard, ay as PaymentConnect, az as PaymentConnectExchange, aA as PaymentConnectParams, aB as PaymentCustomer, aC as PaymentGatewayCode, aD as PaymentMerchantPricing, aE as PaymentPayload, aF as PaymentPluginConfig, aG as PaymentRenderMode, aH as PaymentResult, aI as PaymentSessionFees, aJ as PaymentSessionPayload, aK as PaymentSessionResult, aL as PaymentSettlementFees, aM as PaymentVerifyPayload, aN as PaymentWebhookSettlement, aO as PlaceSupplierOrderInput, aP as Plugin, aQ as PluginActionContext, aR as PluginActionResult, aS as PluginAuthor, aT as PluginConfigFieldDependency, aU as PluginFactory, aV as PluginManifest, aW as RepeaterBlock, aX as RepeaterSource, aY as SecretStore, aZ as SequenceStore, a_ as SetupAction, a$ as SetupLayout, b0 as SetupLayoutValidation, b1 as SetupStep, b2 as ShipmentAddress, b3 as ShipmentParcel, b4 as ShipmentResult, b5 as ShippingDefaultConfig, b6 as ShippingFeature, b7 as ShippingPluginConfig, b8 as ShippingQuote, b9 as ShippingQuoteParams, ba as ShippingStaticConfig, bb as StepStatusFrom, bc as StepStatusFromAction, bd as StepStatusFromFields, be as StepStatusSource, bf as StorageBroker, bg as SupplierCatalogQuery, bh as SupplierFulfillmentEvent, bi as SupplierListing, bj as SupplierListingAttribute, bk as SupplierListingPage, bl as SupplierListingVariant, bm as SupplierMoney, bn as SupplierOrderAddressLevel, bo as SupplierOrderCustomer, bp as SupplierOrderLine, bq as SupplierOrderResult, br as SupplierOrderStatus, bs as SupplierShipTo, bt as SupplierStock, bu as SuppliersDefaultConfig, bv as SuppliersFeature, bw as SuppliersPluginConfig, bx as SuppliersStaticConfig, by as TabItem, bz as TabsBlock, bA as ToggleBlock, bB as TrackingEvent, bC as TransactionStatus, bD as UiContribution, bE as UiContributionsValidation, bF as VoidInvoiceInput, bG as WebhookSignatureResult, bH as analyticsCapability, bI as capability, bJ as crossValidateSetupLayout, bK as definePlugin, bL as invoicingCapability, bM as isConfigurablePlugin, bN as isPluginFactory, bO as minorUnitDigits, bP as paymentCapability, bQ as shippingCapability, bR as suppliersCapability, bS as toMajorUnits, bT as toMinorUnits, bU as uiCapability, bV as validatePluginAuthor, bW as validateSetupLayout, bX as validateUiContributions } from './host-api-Eeb42fR2.mjs';
 
 declare const PAYMENT_PLUGIN_TOKEN: "PAYMENT_PLUGINS";
 declare const SHIPPING_PLUGIN_TOKEN: "SHIPPING_PLUGINS";
@@ -74,7 +74,7 @@ declare function checkPermissions(required: string[], grantedRaw: string[]): Per
  * - MINOR: additive (new optional fields, new tokens) — backwards compatible.
  * - PATCH: docs/fixes with zero shape changes.
  */
-declare const SDK_VERSION = "0.6.8";
+declare const SDK_VERSION = "0.6.9";
 /**
  * True when a plugin built against `pluginSdkVersion` can run on a host that
  * ships `hostSdkVersion`. Rule: same major, host minor >= plugin minor.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-BbIT_sLc.js';
-export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsStaticConfig, n as AnalyticsUserData, o as AnalyticsUtm, p as AuthorValidation, B as BannerBlock, q as Block, r as BlockBase, s as BlockType, t as CalloutBlock, u as Capability, v as CapabilityKind, w as CardBlock, x as CodConfig, y as CodFeeConfig, z as CodFeeType, D as ConditionalBlock, E as ConditionalEquals, G as ConditionalWhen, H as ConfigurablePlugin, I as ContentActionVariant, J as ContentBlock, K as ContentBlockType, L as CopyFieldBlock, M as CreateShipmentParams, N as DispatchContext, O as DividerBlock, Q as DomainEventHandler, R as DomainEventName, T as EmbedInit, U as FieldBlock, V as FieldOption, W as FieldVariant, X as GatewayEnvironment, Y as GatewayStaticConfig, Z as GroupBlock, _ as HostApi, $ as HttpClient, a0 as HttpRequest, a1 as HttpResponse, a2 as IAnalyticsPlugin, a3 as IInvoicingPlugin, a4 as IPaymentPlugin, a5 as IPlugin, a6 as IShippingPlugin, a7 as ISuppliersPlugin, a8 as IUiPlugin, a9 as InlineRowBlock, aa as InvoiceDocumentType, ab as InvoiceLine, ac as InvoiceMoney, ad as InvoiceParty, ae as InvoiceRequest, af as InvoiceResult, ag as InvoiceStatus, ah as InvoiceTax, ai as InvoicingDefaultConfig, aj as InvoicingFeature, ak as InvoicingPluginConfig, al as InvoicingStaticConfig, am as KeyValueBlock, an as KeyValueRow, ao as LayoutMode, ap as Logger, aq as MarkdownBlock, ar as MessageVariant, as as PaymentCard, at as PaymentConnect, au as PaymentConnectExchange, av as PaymentConnectParams, aw as PaymentCustomer, ax as PaymentGatewayCode, ay as PaymentPayload, az as PaymentPluginConfig, aA as PaymentRenderMode, aB as PaymentResult, aC as PaymentSessionPayload, aD as PaymentSessionResult, aE as PaymentVerifyPayload, aF as PlaceSupplierOrderInput, aG as Plugin, aH as PluginActionContext, aI as PluginActionResult, aJ as PluginAuthor, aK as PluginConfigFieldDependency, aL as PluginFactory, aM as PluginManifest, aN as RepeaterBlock, aO as RepeaterSource, aP as SecretStore, aQ as SequenceStore, aR as SetupAction, aS as SetupLayout, aT as SetupLayoutValidation, aU as SetupStep, aV as ShipmentAddress, aW as ShipmentParcel, aX as ShipmentResult, aY as ShippingDefaultConfig, aZ as ShippingFeature, a_ as ShippingPluginConfig, a$ as ShippingQuote, b0 as ShippingQuoteParams, b1 as ShippingStaticConfig, b2 as StepStatusFrom, b3 as StepStatusFromAction, b4 as StepStatusFromFields, b5 as StepStatusSource, b6 as StorageBroker, b7 as SupplierCatalogQuery, b8 as SupplierFulfillmentEvent, b9 as SupplierListing, ba as SupplierListingAttribute, bb as SupplierListingPage, bc as SupplierListingVariant, bd as SupplierMoney, be as SupplierOrderAddressLevel, bf as SupplierOrderCustomer, bg as SupplierOrderLine, bh as SupplierOrderResult, bi as SupplierOrderStatus, bj as SupplierShipTo, bk as SupplierStock, bl as SuppliersDefaultConfig, bm as SuppliersFeature, bn as SuppliersPluginConfig, bo as SuppliersStaticConfig, bp as TabItem, bq as TabsBlock, br as ToggleBlock, bs as TrackingEvent, bt as TransactionStatus, bu as UiContribution, bv as UiContributionsValidation, bw as VoidInvoiceInput, bx as WebhookSignatureResult, by as analyticsCapability, bz as capability, bA as crossValidateSetupLayout, bB as definePlugin, bC as invoicingCapability, bD as isConfigurablePlugin, bE as isPluginFactory, bF as paymentCapability, bG as shippingCapability, bH as suppliersCapability, bI as uiCapability, bJ as validatePluginAuthor, bK as validateSetupLayout, bL as validateUiContributions } from './host-api-BbIT_sLc.js';
+import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-Eeb42fR2.js';
+export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsPurchasePolicy, n as AnalyticsStaticConfig, o as AnalyticsUserData, p as AnalyticsUtm, q as AuthorValidation, B as BannerBlock, r as Block, s as BlockBase, t as BlockType, u as CalloutBlock, v as Capability, w as CapabilityKind, x as CardBlock, y as CarrierServiceMode, z as CarrierSettlement, D as CodConfig, E as CodFeeConfig, G as CodFeeType, H as CodPurchaseTrigger, I as ConditionalBlock, J as ConditionalEquals, K as ConditionalWhen, L as ConfigurablePlugin, M as ContentActionVariant, N as ContentBlock, O as ContentBlockType, Q as CopyFieldBlock, R as CreateShipmentParams, T as DispatchContext, U as DividerBlock, V as DomainEventHandler, W as DomainEventName, X as EmbedInit, Y as FieldBlock, Z as FieldOption, _ as FieldVariant, $ as GatewayEnvironment, a0 as GatewayFeeConfig, a1 as GatewayStaticConfig, a2 as GroupBlock, a3 as HostApi, a4 as HttpClient, a5 as HttpRequest, a6 as HttpResponse, a7 as IAnalyticsPlugin, a8 as IInvoicingPlugin, a9 as IPaymentPlugin, aa as IPlugin, ab as IShippingPlugin, ac as ISuppliersPlugin, ad as IUiPlugin, ae as InlineRowBlock, af as InvoiceDocumentType, ag as InvoiceLine, ah as InvoiceMoney, ai as InvoiceParty, aj as InvoiceRequest, ak as InvoiceResult, al as InvoiceStatus, am as InvoiceTax, an as InvoicingDefaultConfig, ao as InvoicingFeature, ap as InvoicingPluginConfig, aq as InvoicingStaticConfig, ar as KeyValueBlock, as as KeyValueRow, at as LayoutMode, au as Logger, av as MarkdownBlock, aw as MessageVariant, ax as PaymentCard, ay as PaymentConnect, az as PaymentConnectExchange, aA as PaymentConnectParams, aB as PaymentCustomer, aC as PaymentGatewayCode, aD as PaymentMerchantPricing, aE as PaymentPayload, aF as PaymentPluginConfig, aG as PaymentRenderMode, aH as PaymentResult, aI as PaymentSessionFees, aJ as PaymentSessionPayload, aK as PaymentSessionResult, aL as PaymentSettlementFees, aM as PaymentVerifyPayload, aN as PaymentWebhookSettlement, aO as PlaceSupplierOrderInput, aP as Plugin, aQ as PluginActionContext, aR as PluginActionResult, aS as PluginAuthor, aT as PluginConfigFieldDependency, aU as PluginFactory, aV as PluginManifest, aW as RepeaterBlock, aX as RepeaterSource, aY as SecretStore, aZ as SequenceStore, a_ as SetupAction, a$ as SetupLayout, b0 as SetupLayoutValidation, b1 as SetupStep, b2 as ShipmentAddress, b3 as ShipmentParcel, b4 as ShipmentResult, b5 as ShippingDefaultConfig, b6 as ShippingFeature, b7 as ShippingPluginConfig, b8 as ShippingQuote, b9 as ShippingQuoteParams, ba as ShippingStaticConfig, bb as StepStatusFrom, bc as StepStatusFromAction, bd as StepStatusFromFields, be as StepStatusSource, bf as StorageBroker, bg as SupplierCatalogQuery, bh as SupplierFulfillmentEvent, bi as SupplierListing, bj as SupplierListingAttribute, bk as SupplierListingPage, bl as SupplierListingVariant, bm as SupplierMoney, bn as SupplierOrderAddressLevel, bo as SupplierOrderCustomer, bp as SupplierOrderLine, bq as SupplierOrderResult, br as SupplierOrderStatus, bs as SupplierShipTo, bt as SupplierStock, bu as SuppliersDefaultConfig, bv as SuppliersFeature, bw as SuppliersPluginConfig, bx as SuppliersStaticConfig, by as TabItem, bz as TabsBlock, bA as ToggleBlock, bB as TrackingEvent, bC as TransactionStatus, bD as UiContribution, bE as UiContributionsValidation, bF as VoidInvoiceInput, bG as WebhookSignatureResult, bH as analyticsCapability, bI as capability, bJ as crossValidateSetupLayout, bK as definePlugin, bL as invoicingCapability, bM as isConfigurablePlugin, bN as isPluginFactory, bO as minorUnitDigits, bP as paymentCapability, bQ as shippingCapability, bR as suppliersCapability, bS as toMajorUnits, bT as toMinorUnits, bU as uiCapability, bV as validatePluginAuthor, bW as validateSetupLayout, bX as validateUiContributions } from './host-api-Eeb42fR2.js';
 
 declare const PAYMENT_PLUGIN_TOKEN: "PAYMENT_PLUGINS";
 declare const SHIPPING_PLUGIN_TOKEN: "SHIPPING_PLUGINS";
@@ -74,7 +74,7 @@ declare function checkPermissions(required: string[], grantedRaw: string[]): Per
  * - MINOR: additive (new optional fields, new tokens) — backwards compatible.
  * - PATCH: docs/fixes with zero shape changes.
  */
-declare const SDK_VERSION = "0.6.8";
+declare const SDK_VERSION = "0.6.9";
 /**
  * True when a plugin built against `pluginSdkVersion` can run on a host that
  * ships `hostSdkVersion`. Rule: same major, host minor >= plugin minor.

package/dist/index.js

@@ -60,10 +60,13 @@ __export(index_exports, {
   isPermissionGranted: () => isPermissionGranted,
   isPluginFactory: () => isPluginFactory,
   isSdkCompatible: () => isSdkCompatible,
+  minorUnitDigits: () => minorUnitDigits,
   parsePermission: () => parsePermission,
   paymentCapability: () => paymentCapability,
   shippingCapability: () => shippingCapability,
   suppliersCapability: () => suppliersCapability,
+  toMajorUnits: () => toMajorUnits,
+  toMinorUnits: () => toMinorUnits,
   uiCapability: () => uiCapability,
   validatePluginAuthor: () => validatePluginAuthor,
   validateSetupLayout: () => validateSetupLayout,
@@ -214,6 +217,26 @@ var AnalyticsFeature = /* @__PURE__ */ ((AnalyticsFeature2) => {
   AnalyticsFeature2["PageViews"] = "page-views";
   return AnalyticsFeature2;
 })(AnalyticsFeature || {});
+function minorUnitDigits(currency) {
+  try {
+    return new Intl.NumberFormat("en", {
+      style: "currency",
+      currency: currency.toUpperCase()
+    }).resolvedOptions().maximumFractionDigits;
+  } catch {
+    return 2;
+  }
+}
+function toMinorUnits(major, currency) {
+  return {
+    amountMinor: Math.round(major * 10 ** minorUnitDigits(currency)),
+    currency
+  };
+}
+function toMajorUnits(money) {
+  const digits = minorUnitDigits(money.currency);
+  return Number((money.amountMinor / 10 ** digits).toFixed(digits));
+}
 
 // src/invoicing.ts
 var InvoicingFeature = /* @__PURE__ */ ((InvoicingFeature2) => {
@@ -717,7 +740,7 @@ function checkPermissions(required, grantedRaw) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.6.8";
+var SDK_VERSION = "0.6.9";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
@@ -774,10 +797,13 @@ function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   isPermissionGranted,
   isPluginFactory,
   isSdkCompatible,
+  minorUnitDigits,
   parsePermission,
   paymentCapability,
   shippingCapability,
   suppliersCapability,
+  toMajorUnits,
+  toMinorUnits,
   uiCapability,
   validatePluginAuthor,
   validateSetupLayout,

package/dist/index.mjs

@@ -155,6 +155,26 @@ var AnalyticsFeature = /* @__PURE__ */ ((AnalyticsFeature2) => {
   AnalyticsFeature2["PageViews"] = "page-views";
   return AnalyticsFeature2;
 })(AnalyticsFeature || {});
+function minorUnitDigits(currency) {
+  try {
+    return new Intl.NumberFormat("en", {
+      style: "currency",
+      currency: currency.toUpperCase()
+    }).resolvedOptions().maximumFractionDigits;
+  } catch {
+    return 2;
+  }
+}
+function toMinorUnits(major, currency) {
+  return {
+    amountMinor: Math.round(major * 10 ** minorUnitDigits(currency)),
+    currency
+  };
+}
+function toMajorUnits(money) {
+  const digits = minorUnitDigits(money.currency);
+  return Number((money.amountMinor / 10 ** digits).toFixed(digits));
+}
 
 // src/invoicing.ts
 var InvoicingFeature = /* @__PURE__ */ ((InvoicingFeature2) => {
@@ -651,7 +671,7 @@ function isPluginFactory(value) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.6.8";
+var SDK_VERSION = "0.6.9";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
@@ -707,10 +727,13 @@ export {
   isPermissionGranted,
   isPluginFactory,
   isSdkCompatible,
+  minorUnitDigits,
   parsePermission,
   paymentCapability,
   shippingCapability,
   suppliersCapability,
+  toMajorUnits,
+  toMinorUnits,
   uiCapability,
   validatePluginAuthor,
   validateSetupLayout,

package/dist/testing/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as HostApi, a0 as HttpRequest, R as DomainEventName, u as Capability, Q as DomainEventHandler, a1 as HttpResponse, N as DispatchContext } from '../host-api-BbIT_sLc.mjs';
+import { a3 as HostApi, a5 as HttpRequest, W as DomainEventName, v as Capability, V as DomainEventHandler, a6 as HttpResponse, T as DispatchContext } from '../host-api-Eeb42fR2.mjs';
 
 /** Every recorded interaction, keyed by `"port.method"`. */
 interface MockHostCalls {

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { _ as HostApi, a0 as HttpRequest, R as DomainEventName, u as Capability, Q as DomainEventHandler, a1 as HttpResponse, N as DispatchContext } from '../host-api-BbIT_sLc.js';
+import { a3 as HostApi, a5 as HttpRequest, W as DomainEventName, v as Capability, V as DomainEventHandler, a6 as HttpResponse, T as DispatchContext } from '../host-api-Eeb42fR2.js';
 
 /** Every recorded interaction, keyed by `"port.method"`. */
 interface MockHostCalls {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivoa/plugin-sdk",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "description": "Public contracts for Vivoa plugins (types, DI tokens, config + setup-layout validators)",
   "license": "MIT",
   "author": "Vivoa",
@@ -39,14 +39,6 @@
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
-  "scripts": {
-    "build": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --clean --target node18",
-    "dev": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --watch --target node18",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build"
-  },
   "dependencies": {
     "superstruct": "^2.0.2"
   },
@@ -55,5 +47,12 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --clean --target node18",
+    "dev": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --watch --target node18",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
   }
-}
+}