@vivoa/plugin-sdk 0.6.7 → 0.6.9

package/dist/{host-api-yX49e7zE.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[];
@@ -540,6 +633,40 @@ interface WebhookSignatureResult {
     isValid: boolean;
     error?: string;
 }
+/**
+ * "Connect" handshake (authorization code + PKCE) a gateway can offer so a
+ * merchant links their account with one click instead of pasting credentials.
+ * The HOST owns state, code_verifier and the callback route; the plugin only
+ * knows the gateway's URLs and wire format. STATELESS like every other verb.
+ */
+interface PaymentConnectParams {
+    /** Opaque anti-CSRF value; echoed back on the callback. */
+    state: string;
+    /** base64url(SHA-256(code_verifier)) — S256. */
+    codeChallenge: string;
+    /** Host callback the gateway redirects the merchant to (`?code&state`). */
+    redirectUri: string;
+    /** Host webhook endpoint for this gateway, to register on the gateway side. */
+    webhookUrl: string;
+    /** Store origin (https://host) — the only origin the gateway may wire to. */
+    origin: string;
+    /** Store display name, shown on the gateway's consent screen. */
+    storeName: string;
+}
+interface PaymentConnectExchange {
+    code: string;
+    codeVerifier: string;
+    redirectUri: string;
+}
+interface PaymentConnect {
+    /** Where to send the merchant to log in and approve the store. */
+    authorizeUrl(params: PaymentConnectParams, ctx: DispatchContext): string;
+    /**
+     * Redeem the authorization code. Returns a CONFIG PATCH (credentials etc.)
+     * the host persists exactly like an admin save.
+     */
+    exchange(params: PaymentConnectExchange, ctx: DispatchContext): Promise<Record<string, unknown>>;
+}
 interface IPaymentPlugin extends IPlugin {
     readonly gatewayCode: PaymentGatewayCode;
     readonly staticConfig: GatewayStaticConfig;
@@ -548,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
@@ -564,6 +705,8 @@ interface IPaymentPlugin extends IPlugin {
      * call via `ctx.config` (INV-4); no card data is ever passed here (INV-1).
      */
     createPaymentSession?(payload: PaymentSessionPayload, ctx: DispatchContext): Promise<PaymentSessionResult>;
+    /** OPTIONAL one-click account linking (see {@link PaymentConnect}). */
+    readonly connect?: PaymentConnect;
 }
 
 declare enum ShippingFeature {
@@ -670,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;
@@ -679,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
@@ -756,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;
@@ -797,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;
@@ -916,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`). */
@@ -940,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.
@@ -968,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;
@@ -1530,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, StepStatusFrom 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 PaymentSessionResult as aA, type PaymentVerifyPayload as aB, type PlaceSupplierOrderInput as aC, type Plugin as aD, type PluginActionContext as aE, type PluginActionResult as aF, type PluginAuthor as aG, type PluginConfigFieldDependency as aH, type PluginFactory as aI, type PluginManifest as aJ, type RepeaterBlock as aK, RepeaterSource as aL, type SecretStore as aM, type SequenceStore as aN, type SetupAction as aO, type SetupLayout as aP, type SetupLayoutValidation as aQ, type SetupStep as aR, type ShipmentAddress as aS, type ShipmentParcel as aT, type ShipmentResult as aU, type ShippingDefaultConfig as aV, ShippingFeature as aW, type ShippingPluginConfig as aX, type ShippingQuote as aY, type ShippingQuoteParams as aZ, type ShippingStaticConfig 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 PaymentCustomer as at, type PaymentGatewayCode as au, type PaymentPayload as av, type PaymentPluginConfig as aw, type PaymentRenderMode as ax, type PaymentResult as ay, type PaymentSessionPayload as az, type AccordionSection as b, type StepStatusFromAction as b0, type StepStatusFromFields as b1, type StepStatusSource as b2, type StorageBroker as b3, type SupplierCatalogQuery as b4, type SupplierFulfillmentEvent as b5, type SupplierListing as b6, type SupplierListingAttribute as b7, type SupplierListingPage as b8, type SupplierListingVariant as b9, isConfigurablePlugin as bA, isPluginFactory as bB, paymentCapability as bC, shippingCapability as bD, suppliersCapability as bE, uiCapability as bF, validatePluginAuthor as bG, validateSetupLayout as bH, validateUiContributions as bI, type SupplierMoney as ba, type SupplierOrderAddressLevel as bb, type SupplierOrderCustomer as bc, type SupplierOrderLine as bd, type SupplierOrderResult as be, type SupplierOrderStatus as bf, type SupplierShipTo as bg, type SupplierStock as bh, type SuppliersDefaultConfig as bi, SuppliersFeature as bj, type SuppliersPluginConfig as bk, type SuppliersStaticConfig as bl, type TabItem as bm, type TabsBlock as bn, type ToggleBlock as bo, type TrackingEvent as bp, TransactionStatus as bq, type UiContribution as br, type UiContributionsValidation as bs, type VoidInvoiceInput as bt, type WebhookSignatureResult as bu, analyticsCapability as bv, capability as bw, crossValidateSetupLayout as bx, definePlugin as by, invoicingCapability 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-yX49e7zE.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[];
@@ -540,6 +633,40 @@ interface WebhookSignatureResult {
     isValid: boolean;
     error?: string;
 }
+/**
+ * "Connect" handshake (authorization code + PKCE) a gateway can offer so a
+ * merchant links their account with one click instead of pasting credentials.
+ * The HOST owns state, code_verifier and the callback route; the plugin only
+ * knows the gateway's URLs and wire format. STATELESS like every other verb.
+ */
+interface PaymentConnectParams {
+    /** Opaque anti-CSRF value; echoed back on the callback. */
+    state: string;
+    /** base64url(SHA-256(code_verifier)) — S256. */
+    codeChallenge: string;
+    /** Host callback the gateway redirects the merchant to (`?code&state`). */
+    redirectUri: string;
+    /** Host webhook endpoint for this gateway, to register on the gateway side. */
+    webhookUrl: string;
+    /** Store origin (https://host) — the only origin the gateway may wire to. */
+    origin: string;
+    /** Store display name, shown on the gateway's consent screen. */
+    storeName: string;
+}
+interface PaymentConnectExchange {
+    code: string;
+    codeVerifier: string;
+    redirectUri: string;
+}
+interface PaymentConnect {
+    /** Where to send the merchant to log in and approve the store. */
+    authorizeUrl(params: PaymentConnectParams, ctx: DispatchContext): string;
+    /**
+     * Redeem the authorization code. Returns a CONFIG PATCH (credentials etc.)
+     * the host persists exactly like an admin save.
+     */
+    exchange(params: PaymentConnectExchange, ctx: DispatchContext): Promise<Record<string, unknown>>;
+}
 interface IPaymentPlugin extends IPlugin {
     readonly gatewayCode: PaymentGatewayCode;
     readonly staticConfig: GatewayStaticConfig;
@@ -548,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
@@ -564,6 +705,8 @@ interface IPaymentPlugin extends IPlugin {
      * call via `ctx.config` (INV-4); no card data is ever passed here (INV-1).
      */
     createPaymentSession?(payload: PaymentSessionPayload, ctx: DispatchContext): Promise<PaymentSessionResult>;
+    /** OPTIONAL one-click account linking (see {@link PaymentConnect}). */
+    readonly connect?: PaymentConnect;
 }
 
 declare enum ShippingFeature {
@@ -670,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;
@@ -679,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
@@ -756,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;
@@ -797,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;
@@ -916,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`). */
@@ -940,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.
@@ -968,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;
@@ -1530,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, StepStatusFrom 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 PaymentSessionResult as aA, type PaymentVerifyPayload as aB, type PlaceSupplierOrderInput as aC, type Plugin as aD, type PluginActionContext as aE, type PluginActionResult as aF, type PluginAuthor as aG, type PluginConfigFieldDependency as aH, type PluginFactory as aI, type PluginManifest as aJ, type RepeaterBlock as aK, RepeaterSource as aL, type SecretStore as aM, type SequenceStore as aN, type SetupAction as aO, type SetupLayout as aP, type SetupLayoutValidation as aQ, type SetupStep as aR, type ShipmentAddress as aS, type ShipmentParcel as aT, type ShipmentResult as aU, type ShippingDefaultConfig as aV, ShippingFeature as aW, type ShippingPluginConfig as aX, type ShippingQuote as aY, type ShippingQuoteParams as aZ, type ShippingStaticConfig 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 PaymentCustomer as at, type PaymentGatewayCode as au, type PaymentPayload as av, type PaymentPluginConfig as aw, type PaymentRenderMode as ax, type PaymentResult as ay, type PaymentSessionPayload as az, type AccordionSection as b, type StepStatusFromAction as b0, type StepStatusFromFields as b1, type StepStatusSource as b2, type StorageBroker as b3, type SupplierCatalogQuery as b4, type SupplierFulfillmentEvent as b5, type SupplierListing as b6, type SupplierListingAttribute as b7, type SupplierListingPage as b8, type SupplierListingVariant as b9, isConfigurablePlugin as bA, isPluginFactory as bB, paymentCapability as bC, shippingCapability as bD, suppliersCapability as bE, uiCapability as bF, validatePluginAuthor as bG, validateSetupLayout as bH, validateUiContributions as bI, type SupplierMoney as ba, type SupplierOrderAddressLevel as bb, type SupplierOrderCustomer as bc, type SupplierOrderLine as bd, type SupplierOrderResult as be, type SupplierOrderStatus as bf, type SupplierShipTo as bg, type SupplierStock as bh, type SuppliersDefaultConfig as bi, SuppliersFeature as bj, type SuppliersPluginConfig as bk, type SuppliersStaticConfig as bl, type TabItem as bm, type TabsBlock as bn, type ToggleBlock as bo, type TrackingEvent as bp, TransactionStatus as bq, type UiContribution as br, type UiContributionsValidation as bs, type VoidInvoiceInput as bt, type WebhookSignatureResult as bu, analyticsCapability as bv, capability as bw, crossValidateSetupLayout as bx, definePlugin as by, invoicingCapability 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-yX49e7zE.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 PaymentCustomer, au as PaymentGatewayCode, av as PaymentPayload, aw as PaymentPluginConfig, ax as PaymentRenderMode, ay as PaymentResult, az as PaymentSessionPayload, aA as PaymentSessionResult, aB as PaymentVerifyPayload, aC as PlaceSupplierOrderInput, aD as Plugin, aE as PluginActionContext, aF as PluginActionResult, aG as PluginAuthor, aH as PluginConfigFieldDependency, aI as PluginFactory, aJ as PluginManifest, aK as RepeaterBlock, aL as RepeaterSource, aM as SecretStore, aN as SequenceStore, aO as SetupAction, aP as SetupLayout, aQ as SetupLayoutValidation, aR as SetupStep, aS as ShipmentAddress, aT as ShipmentParcel, aU as ShipmentResult, aV as ShippingDefaultConfig, aW as ShippingFeature, aX as ShippingPluginConfig, aY as ShippingQuote, aZ as ShippingQuoteParams, a_ as ShippingStaticConfig, a$ as StepStatusFrom, b0 as StepStatusFromAction, b1 as StepStatusFromFields, b2 as StepStatusSource, b3 as StorageBroker, b4 as SupplierCatalogQuery, b5 as SupplierFulfillmentEvent, b6 as SupplierListing, b7 as SupplierListingAttribute, b8 as SupplierListingPage, b9 as SupplierListingVariant, ba as SupplierMoney, bb as SupplierOrderAddressLevel, bc as SupplierOrderCustomer, bd as SupplierOrderLine, be as SupplierOrderResult, bf as SupplierOrderStatus, bg as SupplierShipTo, bh as SupplierStock, bi as SuppliersDefaultConfig, bj as SuppliersFeature, bk as SuppliersPluginConfig, bl as SuppliersStaticConfig, bm as TabItem, bn as TabsBlock, bo as ToggleBlock, bp as TrackingEvent, bq as TransactionStatus, br as UiContribution, bs as UiContributionsValidation, bt as VoidInvoiceInput, bu as WebhookSignatureResult, bv as analyticsCapability, bw as capability, bx as crossValidateSetupLayout, by as definePlugin, bz as invoicingCapability, bA as isConfigurablePlugin, bB as isPluginFactory, bC as paymentCapability, bD as shippingCapability, bE as suppliersCapability, bF as uiCapability, bG as validatePluginAuthor, bH as validateSetupLayout, bI as validateUiContributions } from './host-api-yX49e7zE.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.7";
+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-yX49e7zE.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 PaymentCustomer, au as PaymentGatewayCode, av as PaymentPayload, aw as PaymentPluginConfig, ax as PaymentRenderMode, ay as PaymentResult, az as PaymentSessionPayload, aA as PaymentSessionResult, aB as PaymentVerifyPayload, aC as PlaceSupplierOrderInput, aD as Plugin, aE as PluginActionContext, aF as PluginActionResult, aG as PluginAuthor, aH as PluginConfigFieldDependency, aI as PluginFactory, aJ as PluginManifest, aK as RepeaterBlock, aL as RepeaterSource, aM as SecretStore, aN as SequenceStore, aO as SetupAction, aP as SetupLayout, aQ as SetupLayoutValidation, aR as SetupStep, aS as ShipmentAddress, aT as ShipmentParcel, aU as ShipmentResult, aV as ShippingDefaultConfig, aW as ShippingFeature, aX as ShippingPluginConfig, aY as ShippingQuote, aZ as ShippingQuoteParams, a_ as ShippingStaticConfig, a$ as StepStatusFrom, b0 as StepStatusFromAction, b1 as StepStatusFromFields, b2 as StepStatusSource, b3 as StorageBroker, b4 as SupplierCatalogQuery, b5 as SupplierFulfillmentEvent, b6 as SupplierListing, b7 as SupplierListingAttribute, b8 as SupplierListingPage, b9 as SupplierListingVariant, ba as SupplierMoney, bb as SupplierOrderAddressLevel, bc as SupplierOrderCustomer, bd as SupplierOrderLine, be as SupplierOrderResult, bf as SupplierOrderStatus, bg as SupplierShipTo, bh as SupplierStock, bi as SuppliersDefaultConfig, bj as SuppliersFeature, bk as SuppliersPluginConfig, bl as SuppliersStaticConfig, bm as TabItem, bn as TabsBlock, bo as ToggleBlock, bp as TrackingEvent, bq as TransactionStatus, br as UiContribution, bs as UiContributionsValidation, bt as VoidInvoiceInput, bu as WebhookSignatureResult, bv as analyticsCapability, bw as capability, bx as crossValidateSetupLayout, by as definePlugin, bz as invoicingCapability, bA as isConfigurablePlugin, bB as isPluginFactory, bC as paymentCapability, bD as shippingCapability, bE as suppliersCapability, bF as uiCapability, bG as validatePluginAuthor, bH as validateSetupLayout, bI as validateUiContributions } from './host-api-yX49e7zE.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.7";
+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.7";
+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.7";
+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-yX49e7zE.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-yX49e7zE.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.7",
+  "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"
   }
-}
+}