@sakeetech/viva-payments-core 0.2.1

package/dist/types/card-types.js

@@ -0,0 +1,62 @@
+/**
+ * Viva's numeric CardTypeId → string scheme name mapping.
+ *
+ * Used by `Payments.retrieveTransaction` to populate the normalized
+ * `cardType: string` field for downstream consumers (e.g.,
+ * {@link import('../refunds/strategy.js').resolveRefundStrategy resolveRefundStrategy}).
+ *
+ * Mapping source: `references/viva-docs/md/wh-transaction-payment-created.txt`
+ * (search for `CardTypeId`). Viva documents the following nine values:
+ *
+ *   0 = Visa
+ *   1 = Mastercard
+ *   2 = Diners
+ *   3 = Amex
+ *   4 = Invalid
+ *   5 = Unknown
+ *   6 = Maestro
+ *   7 = Discover
+ *   8 = JCB
+ *
+ * Casing note:
+ *   `resolveRefundStrategy` matches the Fast-Refund eligible-scheme set
+ *   case-sensitively against the string emitted here. The strategy's set
+ *   uses `'MasterCard'` (camelCase). We emit `'MasterCard'` for cardTypeId
+ *   `1` to match — this is the only difference from the doc's raw casing.
+ *   Diners is emitted as the doc's `'Diners'` (no "Club") so future
+ *   eligibility additions key off a single canonical string.
+ *
+ *   The sentinel categories `Invalid` (4) and `Unknown` (5) are intentionally
+ *   NOT exposed as scheme strings — they indicate "no useful card info" and
+ *   `resolveCardType` returns `undefined` for them so the auto-refund
+ *   decision falls through to `auto-no-card-info`.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt — search "CardTypeId"
+ * @see ../refunds/strategy.ts (FAST_REFUND_ELIGIBLE_SCHEMES)
+ * @see docs/STATE-MACHINE.md §3.1
+ */
+export const CARD_TYPE_BY_ID = Object.freeze({
+    0: 'Visa',
+    1: 'MasterCard',
+    2: 'Diners',
+    3: 'Amex',
+    // 4 = Invalid  → intentionally omitted (sentinel, not a scheme)
+    // 5 = Unknown  → intentionally omitted (sentinel, not a scheme)
+    6: 'Maestro',
+    7: 'Discover',
+    8: 'JCB',
+});
+/**
+ * Pure helper — returns the string scheme name for a Viva numeric cardTypeId,
+ * or `undefined` if the id is null/undefined, a known sentinel (Invalid /
+ * Unknown), or not present in the documented mapping.
+ *
+ * Pure, no I/O. Safe to call from anywhere — including refund strategy
+ * decisions and tests.
+ */
+export function resolveCardType(cardTypeId) {
+    if (cardTypeId == null)
+        return undefined;
+    return CARD_TYPE_BY_ID[cardTypeId];
+}
+//# sourceMappingURL=card-types.js.map

package/dist/types/card-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-types.js","sourceRoot":"","sources":["../../src/types/card-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,MAAM,eAAe,GAAqC,MAAM,CAAC,MAAM,CAAC;IAC7E,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,MAAM;IACT,gEAAgE;IAChE,gEAAgE;IAChE,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,KAAK;CACT,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAqC;IAErC,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC"}

package/dist/types/common.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Common primitives shared across the Viva Wallet ISV API surface.
+ *
+ * Covers: currency branding, money representation, ID aliases,
+ * environment enumeration, and pagination helpers.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:487
+ * @see references/viva-docs/md/webhooks-for-payments.txt:383
+ * @see references/viva-docs/md/oauth2-authentication.txt:145
+ */
+/**
+ * ISO 4217 numeric currency code, represented as a three-digit string.
+ * Examples: '978' for EUR, '826' for GBP, '840' for USD.
+ *
+ * Branded so it cannot be confused with an arbitrary string.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:487
+ */
+export type CurrencyCode = string & {
+    readonly __brand: 'CurrencyCode';
+};
+/**
+ * Narrow cast helper — call when you have a validated ISO 4217 numeric string.
+ * Runtime validation lives in the implementation layer (S2/S6).
+ */
+export declare function asCurrencyCode(code: string): CurrencyCode;
+/**
+ * Commonly used ISO 4217 numeric currency codes.
+ * The map provides ergonomic named constants; the type accepts any 3-digit
+ * numeric string so the list is non-exhaustive.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:487
+ */
+export declare const CURRENCY_CODES: {
+    readonly EUR: CurrencyCode;
+    readonly GBP: CurrencyCode;
+    readonly USD: CurrencyCode;
+    readonly PLN: CurrencyCode;
+    readonly RON: CurrencyCode;
+    readonly CZK: CurrencyCode;
+    readonly HUF: CurrencyCode;
+    readonly BGN: CurrencyCode;
+    readonly DKK: CurrencyCode;
+    readonly SEK: CurrencyCode;
+    readonly NOK: CurrencyCode;
+};
+/**
+ * Integer minor units (e.g. EUR 12.34 = 1234n).
+ *
+ * Plan P15 mandates bigint minor units throughout viva-payments-core.
+ * Wire format to/from Viva is a JSON integer; convert at the boundary only.
+ * NEVER use number for amounts.
+ */
+export type MinorUnits = bigint;
+/**
+ * A typed money value combining minor-unit amount with its currency.
+ */
+export interface Money {
+    /** Integer minor units. E.g. 1234n for EUR 12.34. */
+    readonly amount: MinorUnits;
+    /** ISO 4217 numeric currency code. */
+    readonly currency: CurrencyCode;
+}
+/**
+ * UUID string representing a Viva Merchant ID.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:175
+ */
+export type MerchantId = string & {
+    readonly __brand: 'MerchantId';
+};
+/**
+ * UUID string representing a Viva Connected Account ID.
+ * Used for ISV and Marketplace onboarding.
+ *
+ * @see references/viva-docs/md/wh-account-connected.txt:153
+ */
+export type ConnectedAccountId = string & {
+    readonly __brand: 'ConnectedAccountId';
+};
+/**
+ * UUID string representing a Viva Transaction ID.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:193
+ */
+export type TransactionId = string & {
+    readonly __brand: 'TransactionId';
+};
+/**
+ * Long integer (bigint in TS) representing a Viva Order Code.
+ * Viva uses int64 for order codes; docs show values like 2271655739472609.
+ * Stored as bigint to avoid loss of precision beyond Number.MAX_SAFE_INTEGER.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:176
+ */
+export type OrderCode = bigint;
+/**
+ * Viva Wallet API environment selector.
+ *
+ * - `demo`       → https://demo-accounts.vivapayments.com (auth)
+ *                  https://demo-api.vivapayments.com (API)
+ * - `production` → https://accounts.vivapayments.com (auth)
+ *                  https://api.vivapayments.com (API)
+ *
+ * @see references/viva-docs/md/oauth2-authentication.txt:145
+ */
+export type VivaEnvironment = 'demo' | 'production';
+/**
+ * Base URLs for each environment.
+ *
+ * @see references/viva-docs/md/oauth2-authentication.txt:145
+ */
+export interface VivaEnvironmentUrls {
+    readonly authBaseUrl: string;
+    readonly apiBaseUrl: string;
+}
+/**
+ * Well-known base URLs keyed by environment.
+ *
+ * @see references/viva-docs/md/oauth2-authentication.txt:145
+ */
+export declare const ENVIRONMENT_URLS: Record<VivaEnvironment, VivaEnvironmentUrls>;
+/**
+ * Legacy host base URLs (Basic auth endpoints).
+ *
+ * The Viva legacy API lives on `demo.vivapayments.com` / `www.vivapayments.com`.
+ * These hosts are used for endpoints that Viva has NOT migrated to the v2/OAuth2
+ * surface — specifically `POST /api/transactions/{transactionId}` (refund/cancel-transaction).
+ *
+ * Verified against Viva sandbox 2026-04-25 (probe scripts):
+ * - `POST /checkout/v2/transactions/{id}` (v2/OAuth2) → 405 Method Not Allowed.
+ * - `POST /api/transactions/{id}` (legacy/Basic) → 200 with PascalCase response.
+ *
+ * @see references/viva-docs/md/tut-create-recurring-payment.txt:288
+ */
+export declare const LEGACY_HOST: Record<VivaEnvironment, string>;
+/**
+ * Generic page-based pagination wrapper used by data-service list endpoints.
+ *
+ * @see references/viva-docs/md/account-api.txt:1069
+ */
+export interface PaginatedResponse<T> {
+    readonly currentPage: number;
+    readonly pageSize: number;
+    readonly totalPages: number;
+    readonly totalDataCount: number;
+    readonly data: readonly T[];
+    readonly links: PaginationLinks;
+}
+/**
+ * Navigation links returned alongside paginated results.
+ *
+ * @see references/viva-docs/md/account-api.txt:1183
+ */
+export interface PaginationLinks {
+    readonly self: string;
+    readonly next?: string;
+    readonly previous?: string;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEzD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;CAYsB,CAAC;AAMlD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;CACjC;AAMD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAErE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAE3E;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAM/B;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,YAAY,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAShE,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAG9C,CAAC;AAMX;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types/common.js

@@ -0,0 +1,70 @@
+/**
+ * Common primitives shared across the Viva Wallet ISV API surface.
+ *
+ * Covers: currency branding, money representation, ID aliases,
+ * environment enumeration, and pagination helpers.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:487
+ * @see references/viva-docs/md/webhooks-for-payments.txt:383
+ * @see references/viva-docs/md/oauth2-authentication.txt:145
+ */
+/**
+ * Narrow cast helper — call when you have a validated ISO 4217 numeric string.
+ * Runtime validation lives in the implementation layer (S2/S6).
+ */
+export function asCurrencyCode(code) {
+    return code;
+}
+/**
+ * Commonly used ISO 4217 numeric currency codes.
+ * The map provides ergonomic named constants; the type accepts any 3-digit
+ * numeric string so the list is non-exhaustive.
+ *
+ * @see references/viva-docs/md/wh-transaction-payment-created.txt:487
+ */
+export const CURRENCY_CODES = {
+    EUR: asCurrencyCode('978'),
+    GBP: asCurrencyCode('826'),
+    USD: asCurrencyCode('840'),
+    PLN: asCurrencyCode('985'),
+    RON: asCurrencyCode('946'),
+    CZK: asCurrencyCode('203'),
+    HUF: asCurrencyCode('348'),
+    BGN: asCurrencyCode('975'),
+    DKK: asCurrencyCode('208'),
+    SEK: asCurrencyCode('752'),
+    NOK: asCurrencyCode('578'),
+};
+/**
+ * Well-known base URLs keyed by environment.
+ *
+ * @see references/viva-docs/md/oauth2-authentication.txt:145
+ */
+export const ENVIRONMENT_URLS = {
+    demo: {
+        authBaseUrl: 'https://demo-accounts.vivapayments.com',
+        apiBaseUrl: 'https://demo-api.vivapayments.com',
+    },
+    production: {
+        authBaseUrl: 'https://accounts.vivapayments.com',
+        apiBaseUrl: 'https://api.vivapayments.com',
+    },
+};
+/**
+ * Legacy host base URLs (Basic auth endpoints).
+ *
+ * The Viva legacy API lives on `demo.vivapayments.com` / `www.vivapayments.com`.
+ * These hosts are used for endpoints that Viva has NOT migrated to the v2/OAuth2
+ * surface — specifically `POST /api/transactions/{transactionId}` (refund/cancel-transaction).
+ *
+ * Verified against Viva sandbox 2026-04-25 (probe scripts):
+ * - `POST /checkout/v2/transactions/{id}` (v2/OAuth2) → 405 Method Not Allowed.
+ * - `POST /api/transactions/{id}` (legacy/Basic) → 200 with PascalCase response.
+ *
+ * @see references/viva-docs/md/tut-create-recurring-payment.txt:288
+ */
+export const LEGACY_HOST = {
+    demo: 'https://demo.vivapayments.com',
+    production: 'https://www.vivapayments.com',
+};
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAoB,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;IAC1B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC;CACqB,CAAC;AAsFlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiD;IAC5E,IAAI,EAAE;QACJ,WAAW,EAAE,wCAAwC;QACrD,UAAU,EAAE,mCAAmC;KAChD;IACD,UAAU,EAAE;QACV,WAAW,EAAE,mCAAmC;QAChD,UAAU,EAAE,8BAA8B;KAC3C;CACO,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAoC;IAC1D,IAAI,EAAE,+BAA+B;IACrC,UAAU,EAAE,8BAA8B;CAClC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * viva-payments-core/types — barrel re-export.
+ *
+ * Subpath: `viva-payments-core/types`
+ *
+ * Re-exports all types consumed by S2 (auth), S3 (isv), S4 (webhooks),
+ * and S6/S8 (medusa adapter).
+ *
+ * Attribution: types hand-rolled fresh. Structure partially referenced from
+ * @nkhind/vivawallet-sdk for API surface awareness — no code copied.
+ */
+export type { CurrencyCode, MinorUnits, Money, MerchantId, ConnectedAccountId, TransactionId, OrderCode, VivaEnvironment, VivaEnvironmentUrls, PaginatedResponse, PaginationLinks, } from './common.js';
+export { asCurrencyCode, CURRENCY_CODES, ENVIRONMENT_URLS, LEGACY_HOST, } from './common.js';
+export type { OAuth2TokenResponse, CachedToken, ResellerBasicAuthCredentials, AuthStrategy, } from './auth.js';
+export type { CreateOrderRequest, CreateOrderResponse, RetrieveTransactionResponse, RefundRequest, RefundResponse, CancelOrderResponse, } from './isv-payments.js';
+export { CARD_TYPE_BY_ID, resolveCardType, } from './card-types.js';
+export type { CreateConnectedAccountRequest, CreateConnectedAccountResponse, GetConnectedAccountResponse, RegisterWebhookRequest, RetrieveWebhookKeyResponse, } from './isv-accounts.js';
+export type { VivaStatusLetter, VivaTransactionStatus, VivaClaimSubstate, StatusLetterToTransactionStatus, ClaimStatusLetter, TerminalVivaTransactionStatus, NonTerminalVivaTransactionStatus, StatusTransition, StatusTransitionResult, } from './status.js';
+export type { WebhookEnvelope, VivaEventTypeId, TransactionEventData, TransactionPaymentCreatedEventData, TransactionReversalCreatedEventData, TransactionFailedEventData, OrderUpdatedEventData, AccountConnectedEventData, AccountVerificationStatusChangedEventData, VivaWebhookEnvelope, } from './webhook-events.js';
+export { EVENT_TYPES, DEFERRED_EVENT_TYPES, } from './webhook-events.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAEV,YAAY,EACZ,UAAU,EACV,KAAK,EACL,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAEL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EAEV,mBAAmB,EACnB,WAAW,EACX,4BAA4B,EAC5B,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,YAAY,EAEV,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAEV,6BAA6B,EAC7B,8BAA8B,EAC9B,2BAA2B,EAC3B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAEV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,+BAA+B,EAC/B,iBAAiB,EACjB,6BAA6B,EAC7B,gCAAgC,EAChC,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EAEV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,kCAAkC,EAClC,mCAAmC,EACnC,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,EACzB,yCAAyC,EACzC,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,21 @@
+/**
+ * viva-payments-core/types — barrel re-export.
+ *
+ * Subpath: `viva-payments-core/types`
+ *
+ * Re-exports all types consumed by S2 (auth), S3 (isv), S4 (webhooks),
+ * and S6/S8 (medusa adapter).
+ *
+ * Attribution: types hand-rolled fresh. Structure partially referenced from
+ * @nkhind/vivawallet-sdk for API surface awareness — no code copied.
+ */
+export { 
+// common.ts — runtime values
+asCurrencyCode, CURRENCY_CODES, ENVIRONMENT_URLS, LEGACY_HOST, } from './common.js';
+export { 
+// card-types.ts — runtime values
+CARD_TYPE_BY_ID, resolveCardType, } from './card-types.js';
+export { 
+// webhook-events.ts — runtime values
+EVENT_TYPES, DEFERRED_EVENT_TYPES, } from './webhook-events.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,OAAO;AACL,6BAA6B;AAC7B,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,aAAa,CAAC;AAoBrB,OAAO;AACL,iCAAiC;AACjC,eAAe,EACf,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAsCzB,OAAO;AACL,qCAAqC;AACrC,WAAW,EACX,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/types/isv-accounts.d.ts

@@ -0,0 +1,109 @@
+/**
+ * ISV Connected Account + Webhook Registration types.
+ *
+ * Probe-verified 2026-05-11 against `docs/payment-isv-api.yaml`. All shapes
+ * below match the live demo response observed at `demo-api.vivapayments.com`.
+ *
+ * Endpoints (all Bearer auth, OAuth2 scopes
+ * `urn:viva:payments:core:api:isv urn:viva:payments:core:api:redirectcheckout`):
+ *
+ *   - POST /isv/v1/accounts                 — create connected account
+ *   - GET  /isv/v1/accounts/{accountId}     — retrieve connected account
+ *   - POST /isv/v1/webhooks                 — register webhook (204 No Content)
+ *   - GET  /isv/v1/webhooks/token           — generate verification key
+ *
+ * Endpoints NOT in the ISV spec (intentionally absent from this module):
+ *
+ *   - List webhooks  (not exposed; CLI must rely on POST idempotency)
+ *   - Update/Delete webhook  (not exposed; manage via banking UI)
+ *   - Update connected account  (not exposed for ISV; merchant edits via UI)
+ */
+import type { ConnectedAccountId } from './common.js';
+/**
+ * Request body for `POST /isv/v1/accounts`.
+ *
+ * Probe-verified shape. The ISV API does NOT accept `countryCode`, `firstName`,
+ * `lastName`, `currency`, `sendOnboardingEmail`, or `merchantType` — Viva
+ * collects all of those from the merchant during KYC via the invitation URL.
+ */
+export interface CreateConnectedAccountRequest {
+    /** Merchant email address; the invitation link is sent here. */
+    readonly email: string;
+    /** URL the merchant returns to after completing the Viva-hosted onboarding flow. */
+    readonly returnUrl: string;
+    /**
+     * Optional ISV branding shown on Viva's onboarding pages.
+     * `partnerName` and `logoUrl` are required when `branding` is present.
+     */
+    readonly branding?: {
+        readonly partnerName: string;
+        readonly logoUrl: string;
+        /** Hex code, e.g. `#1F2439`. */
+        readonly primaryColor?: string;
+    };
+}
+/**
+ * Response from `POST /isv/v1/accounts` (HTTP 200).
+ *
+ * Probe-verified shape. The onboarding URL lives at `invitation.redirectUrl`
+ * — not at a top-level `redirectUrl` field.
+ */
+export interface CreateConnectedAccountResponse {
+    readonly accountId: ConnectedAccountId;
+    readonly invitation: {
+        readonly email: string;
+        /** Viva-hosted onboarding URL. Only functional in production. */
+        readonly redirectUrl: string;
+        /** ISO 8601 timestamp. */
+        readonly created: string;
+    };
+}
+/**
+ * Response from `GET /isv/v1/accounts/{accountId}` (HTTP 200).
+ *
+ * Probe-verified shape. All scalar fields are nullable when the account has
+ * not been verified — `merchantId` is the field consumers care about most;
+ * it remains `null` until `verified === true`.
+ */
+export interface GetConnectedAccountResponse {
+    readonly accountId: ConnectedAccountId;
+    /** Populated only after KYC is complete. Use as `merchantId` query param on createOrder. */
+    readonly merchantId: string | null;
+    readonly email: string | null;
+    /** `true` once Viva has verified the merchant via KYC/KYB. */
+    readonly verified: boolean;
+    /** `true` when the merchant can accept card payments. Maps to `vivaPayoutsEnabled` locally. */
+    readonly acquiringEnabled: boolean;
+    readonly created: string | null;
+    readonly taxNumber: string | null;
+    readonly vatNumber: string | null;
+    readonly legalName: string | null;
+    readonly registrationNumber: string | null;
+    readonly invitation: {
+        readonly email: string | null;
+        readonly redirectUrl: string | null;
+        readonly created: string | null;
+    };
+}
+/**
+ * Request body for `POST /isv/v1/webhooks`.
+ *
+ * Probe-verified shape. The spec does NOT include `isActive` — the API has no
+ * concept of inactive webhook registrations.
+ */
+export interface RegisterWebhookRequest {
+    /** Numeric Viva EventTypeId (e.g. 1796 = Transaction Payment Created). */
+    readonly eventTypeId: number;
+    /** HTTPS URL that will receive webhook POST notifications. */
+    readonly url: string;
+}
+/**
+ * Response from `GET /isv/v1/webhooks/token` (HTTP 200).
+ *
+ * The returned `key` must be echoed in the URL-verify GET handshake on the
+ * webhook endpoint so Viva can confirm ownership.
+ */
+export interface RetrieveWebhookKeyResponse {
+    readonly key: string;
+}
+//# sourceMappingURL=isv-accounts.d.ts.map

package/dist/types/isv-accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isv-accounts.d.ts","sourceRoot":"","sources":["../../src/types/isv-accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMtD;;;;;;GAMG;AACH,MAAM,WAAW,6BAA6B;IAC5C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,gCAAgC;QAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,iEAAiE;QACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,0BAA0B;QAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,+FAA+F;IAC/F,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;CACH;AAMD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/isv-accounts.js

@@ -0,0 +1,22 @@
+/**
+ * ISV Connected Account + Webhook Registration types.
+ *
+ * Probe-verified 2026-05-11 against `docs/payment-isv-api.yaml`. All shapes
+ * below match the live demo response observed at `demo-api.vivapayments.com`.
+ *
+ * Endpoints (all Bearer auth, OAuth2 scopes
+ * `urn:viva:payments:core:api:isv urn:viva:payments:core:api:redirectcheckout`):
+ *
+ *   - POST /isv/v1/accounts                 — create connected account
+ *   - GET  /isv/v1/accounts/{accountId}     — retrieve connected account
+ *   - POST /isv/v1/webhooks                 — register webhook (204 No Content)
+ *   - GET  /isv/v1/webhooks/token           — generate verification key
+ *
+ * Endpoints NOT in the ISV spec (intentionally absent from this module):
+ *
+ *   - List webhooks  (not exposed; CLI must rely on POST idempotency)
+ *   - Update/Delete webhook  (not exposed; manage via banking UI)
+ *   - Update connected account  (not exposed for ISV; merchant edits via UI)
+ */
+export {};
+//# sourceMappingURL=isv-accounts.js.map

package/dist/types/isv-accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isv-accounts.js","sourceRoot":"","sources":["../../src/types/isv-accounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}