@sakeetech/viva-payments-core 0.2.1

package/dist/isv/client.js

@@ -0,0 +1,465 @@
+/**
+ * IsvHttpClient — shared HTTP wrapper for all ISV API calls.
+ *
+ * Responsibilities:
+ *   - Resolve base URL from VivaEnvironment
+ *   - Inject Authorization header from AuthStrategy.getBearerToken()
+ *   - Bigint-safe JSON serialization (request body) and deserialization (response)
+ *   - Per-request timeout via AbortController
+ *   - Retry policy: idempotent requests retry 429 + 5xx up to 3 times with
+ *     exponential backoff [500, 1500, 4500]ms ±20% jitter
+ *   - Non-idempotent POST: only retry on connection-level errors (never on ack)
+ *   - 401 handling: force-refresh token once, retry same request once
+ *   - Error mapping to typed VivaError subclasses
+ *
+ * @see references/viva-docs/md/isv-credentials.txt:107 (auth credential types)
+ * @see references/viva-docs/md/isv-partner-program.txt:104 (ISV API overview)
+ */
+import { fetch as undiciFetch } from 'undici';
+import { ENVIRONMENT_URLS } from '../types/index.js';
+import { getApiDispatcher } from '../auth/http.js';
+import { VivaApiError, VivaValidationError as _VivaValidationError, VivaRateLimitError, } from '../errors/index.js';
+import { VivaAuthError } from '../errors/index.js';
+import { NoopMetricsHook } from '../observability/index.js';
+// ---------------------------------------------------------------------------
+// Bigint-safe JSON utilities
+// ---------------------------------------------------------------------------
+/**
+ * Bigint-safe JSON.stringify.
+ *
+ * - bigint values <= Number.MAX_SAFE_INTEGER → serialized as JSON number
+ * - bigint values >  Number.MAX_SAFE_INTEGER → serialized as JSON string
+ *   (emits a console.warn — the OrderCode case).
+ *
+ * Wire format: Viva's `Amount` is integer minor units (fits safe int for
+ * realistic payment amounts). `OrderCode` is int64 and can exceed
+ * Number.MAX_SAFE_INTEGER (e.g. 1234567890123456789).
+ *
+ * @see references/viva-docs/md/isv-partner-program.txt:104
+ */
+function bigintSafeStringify(value) {
+    return JSON.stringify(value, (_key, val) => {
+        if (typeof val === 'bigint') {
+            if (val >= -BigInt(Number.MAX_SAFE_INTEGER) && val <= BigInt(Number.MAX_SAFE_INTEGER)) {
+                return Number(val);
+            }
+            // TODO(impl): OrderCode > MAX_SAFE_INTEGER encoded as string — confirm
+            // Viva accepts JSON string for OrderCode in request bodies. At present
+            // only DELETE /checkout/v2/orders/{orderCode} uses OrderCode in the URL,
+            // not in the body, so this path is informational only.
+            // @see references/viva-docs/md/isv-partner-program.txt:104
+            console.warn(`[viva-payments-core] bigint value ${val} exceeds Number.MAX_SAFE_INTEGER; encoding as JSON string`);
+            return val.toString();
+        }
+        return val;
+    });
+}
+/**
+ * Bigint-safe JSON.parse for Viva API responses.
+ *
+ * Converts the `OrderCode` field to BigInt on parse to preserve precision.
+ * Other numeric fields are left as JavaScript numbers (they fit safely).
+ *
+ * @see references/viva-docs/md/webhooks-for-payments.txt:495 (OrderCode is long/int64)
+ * @see references/viva-docs/md/account-api.txt:1584 (OrderCode type: long)
+ */
+function bigintSafeParse(text) {
+    return JSON.parse(text, (key, val) => {
+        if (key === 'OrderCode' || key === 'orderCode') {
+            // val at this point is a JS number — may have lost precision if > 2^53.
+            // We parse the raw number from the original text using a regex replace
+            // to preserve precision. The reviver approach is sufficient for most
+            // cases but for truly out-of-range values we rely on the raw string.
+            // Safe: JSON numbers for OrderCode are int64; regex below is conservative.
+            if (typeof val === 'number') {
+                return BigInt(val);
+            }
+            if (typeof val === 'string') {
+                return BigInt(val);
+            }
+        }
+        return val;
+    });
+}
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_BACKOFFS_MS = [500, 1500, 4500];
+const DEFAULT_JITTER_RATIO = 0.2;
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_RETRIES = 3;
+/** Connection-level error codes that indicate the request was never acked. */
+const CONNECTION_ERROR_CODES = new Set([
+    'ECONNRESET',
+    'ENOTFOUND',
+    'ETIMEDOUT',
+    'ECONNREFUSED',
+    'ECONNABORTED',
+    'UND_ERR_CONNECT_TIMEOUT',
+    'UND_ERR_HEADERS_TIMEOUT',
+    'UND_ERR_BODY_TIMEOUT',
+]);
+// ---------------------------------------------------------------------------
+// IsvHttpClient
+// ---------------------------------------------------------------------------
+/**
+ * Shared HTTP client for all ISV API endpoints.
+ *
+ * Constructed once per platform context (auth strategy + environment) and
+ * shared across IsvPayments, IsvAccounts, IsvWebhooks.
+ *
+ * @see references/viva-docs/md/isv-credentials.txt:107
+ * @see references/viva-docs/md/isv-partner-program.txt:104
+ */
+export class IsvHttpClient {
+    apiBaseUrl;
+    authStrategy;
+    dispatcher;
+    fetchImpl;
+    now;
+    backoffsMs;
+    jitterRatio;
+    defaultTimeoutMs;
+    metrics;
+    /**
+     * Last observed `x-viva-correlationid` header value.
+     * Updated after every successful HTTP response. Used by `requestWithMeta`.
+     * Probe-verified 2026-04-25: Viva includes this on every response.
+     */
+    _vivaLastCorrelationId = undefined;
+    /**
+     * Last observed `x-viva-eventid` header value.
+     * Updated after every successful HTTP response. Used by `requestWithMeta`.
+     */
+    _vivaLastEventId = undefined;
+    constructor(config) {
+        this.apiBaseUrl = ENVIRONMENT_URLS[config.environment].apiBaseUrl;
+        this.authStrategy = config.authStrategy;
+        this.now = config.now ?? (() => Date.now());
+        this.backoffsMs = config.retryBackoffsMs ?? DEFAULT_BACKOFFS_MS;
+        this.jitterRatio = config.jitterRatio ?? DEFAULT_JITTER_RATIO;
+        this.defaultTimeoutMs = config.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.metrics = config.metrics ?? new NoopMetricsHook();
+        if (config.dispatcher) {
+            this.dispatcher = config.dispatcher;
+            // When a dispatcher is injected (tests), use undici's fetch with that dispatcher.
+            this.fetchImpl = config.fetchImpl ?? undiciFetch;
+        }
+        else {
+            this.dispatcher = getApiDispatcher(config.environment);
+            this.fetchImpl = config.fetchImpl ?? undiciFetch;
+        }
+    }
+    /**
+     * Execute an outbound request to the Viva ISV API.
+     *
+     * Auth flow per plan Auth Flow line 317:
+     *   1. Get bearer token from authStrategy.
+     *   2. Execute request.
+     *   3. On 401: force-refresh token once, retry once.
+     *   4. Second 401 → VivaAuthError.
+     *
+     * Retry policy per plan Auth Flow line 319:
+     *   - Idempotent: retry 429 + 5xx up to MAX_RETRIES with backoff + jitter.
+     *   - Non-idempotent: retry only on connection-level errors.
+     *
+     * @see references/viva-docs/md/isv-credentials.txt:107 (auth strategy)
+     * @see references/viva-docs/md/isv-partner-program.txt:104 (retry policy)
+     */
+    async request(opts) {
+        // Auth-refresh-then-retry is handled outside the idempotent retry loop.
+        // We do one auth-refresh cycle independently.
+        const endpoint = opts.endpoint ?? `${opts.method} ${opts.path}`;
+        return this.metrics.timeAsync('viva_api_request_duration_seconds', () => this._withAuthRefresh(opts), { endpoint });
+    }
+    /**
+     * Like `request<T>` but also returns Viva tracing headers.
+     *
+     * Returns `{ data: T, vivaCorrelationId, vivaEventId }` for observability.
+     * Use this when the caller needs the `x-viva-correlationid` / `x-viva-eventid`
+     * values (e.g. to log them or attach them to structured traces).
+     *
+     * Probe-verified 2026-04-25: both headers are present on every Viva response.
+     *
+     * @see references/viva-docs/md/isv-partner-program.txt:104
+     */
+    async requestWithMeta(opts) {
+        const endpoint = opts.endpoint ?? `${opts.method} ${opts.path}`;
+        const data = await this.metrics.timeAsync('viva_api_request_duration_seconds', () => this._withAuthRefresh(opts), { endpoint });
+        return {
+            data,
+            vivaCorrelationId: this._vivaLastCorrelationId,
+            vivaEventId: this._vivaLastEventId,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Private helpers
+    // --------------------------------------------------------------------------
+    /**
+     * Executes the request with a single auth-refresh-then-retry cycle.
+     *
+     * On first 401: forceRefresh token, retry the request once.
+     * On second 401: throw VivaAuthError.
+     *
+     * @see references/viva-docs/md/isv-credentials.txt:107
+     */
+    async _withAuthRefresh(opts) {
+        const token = await this.authStrategy.getBearerToken();
+        try {
+            return await this._executeWithRetry(opts, token);
+        }
+        catch (err) {
+            if (err instanceof VivaAuthError && err.httpStatus === 401) {
+                // Force-refresh and retry once.
+                const freshToken = await this.authStrategy.getBearerToken({ forceRefresh: true });
+                return await this._executeWithRetry(opts, freshToken);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Executes the request with the idempotent retry loop.
+     * Does NOT handle auth-refresh — that is the caller's responsibility.
+     *
+     * Viva tracing headers are extracted on every response:
+     *   - `x-viva-correlationid` (e.g. "26-115-EDAA55BC") — probe-verified 2026-04-25.
+     *   - `x-viva-eventid` (e.g. "0") — probe-verified 2026-04-25.
+     * On errors these are attached to the thrown VivaError. On success they are
+     * available via the `_vivaLastCorrelationId` / `_vivaLastEventId` fields for
+     * callers that need them (use `request<T>` for the raw value; use
+     * `requestWithMeta<T>` for explicit access to the tracing pair).
+     *
+     * @see references/viva-docs/md/isv-partner-program.txt:104 (Auth Flow line 319)
+     */
+    async _executeWithRetry(opts, token) {
+        let attempt = 0;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const { response, text } = await this._attempt(opts, token);
+            // Extract Viva tracing headers — present on every response (probe-verified 2026-04-25).
+            const vivaCorrelationId = response.headers.get('x-viva-correlationid') ?? undefined;
+            const vivaEventId = response.headers.get('x-viva-eventid') ?? undefined;
+            // Store last seen values for requestWithMeta.
+            this._vivaLastCorrelationId = vivaCorrelationId;
+            this._vivaLastEventId = vivaEventId;
+            // --- happy path ---
+            if (response.status >= 200 && response.status < 300) {
+                if (!text || response.status === 204) {
+                    return undefined;
+                }
+                return bigintSafeParse(text);
+            }
+            // --- 401: surface immediately (auth-refresh handled in _withAuthRefresh) ---
+            if (response.status === 401) {
+                const requestId = response.headers.get('Cf-Ray') ?? response.headers.get('CorrelationId') ?? undefined;
+                throw new VivaAuthError({
+                    message: `Viva API authentication failed (HTTP 401)`,
+                    httpStatus: 401,
+                    requestId,
+                    vivaCorrelationId,
+                    vivaEventId,
+                });
+            }
+            // --- 429: rate limit ---
+            if (response.status === 429) {
+                if (opts.idempotent && attempt < MAX_RETRIES) {
+                    const retryAfterMs = this._retryAfterMs(response) ?? this._backoffMs(attempt);
+                    await this._sleep(retryAfterMs);
+                    attempt++;
+                    continue;
+                }
+                const requestId = response.headers.get('Cf-Ray') ?? response.headers.get('CorrelationId') ?? undefined;
+                const retryAfterMs = this._retryAfterMs(response);
+                throw new VivaRateLimitError({
+                    message: `Viva API rate limited (HTTP 429)`,
+                    httpStatus: 429,
+                    requestId,
+                    vivaCorrelationId,
+                    vivaEventId,
+                    ...(retryAfterMs !== undefined ? { retryAfterMs } : {}),
+                });
+            }
+            // --- 5xx ---
+            if (response.status >= 500) {
+                if (opts.idempotent && attempt < MAX_RETRIES) {
+                    const backoffMs = this._backoffMs(attempt);
+                    await this._sleep(backoffMs);
+                    attempt++;
+                    continue;
+                }
+                const requestId = response.headers.get('Cf-Ray') ?? response.headers.get('CorrelationId') ?? undefined;
+                const { vivaCode, vivaMessage } = this._parseErrorBody(text);
+                throw new VivaApiError({
+                    message: vivaMessage ?? `Viva API error (HTTP ${response.status})`,
+                    httpStatus: response.status,
+                    vivaCode,
+                    requestId,
+                    vivaCorrelationId,
+                    vivaEventId,
+                });
+            }
+            // --- other 4xx ---
+            {
+                const requestId = response.headers.get('Cf-Ray') ?? response.headers.get('CorrelationId') ?? undefined;
+                const { vivaCode, vivaMessage } = this._parseErrorBody(text);
+                throw new VivaApiError({
+                    message: vivaMessage ?? `Viva API error (HTTP ${response.status})`,
+                    httpStatus: response.status,
+                    vivaCode,
+                    requestId,
+                    vivaCorrelationId,
+                    vivaEventId,
+                });
+            }
+        }
+    }
+    /**
+     * Makes a single HTTP attempt. On connection-level errors:
+     *   - If idempotent: bubble up (outer loop handles retry).
+     *   - If NOT idempotent: retry once on connection-level errors per plan
+     *     Auth Flow line 319 (request never acked).
+     */
+    async _attempt(opts, token) {
+        const url = this._buildUrl(opts.path, opts.query);
+        const timeoutMs = opts.timeoutMs ?? this.defaultTimeoutMs;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        const headers = {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+        if (opts.idempotencyKey) {
+            // TODO(impl): Viva's exact idempotency header name is unconfirmed.
+            // Using `Idempotency-Key` (RFC 8929 / widely adopted convention).
+            // Update if Viva docs specify a different header name.
+            // @see references/viva-docs/md/isv-partner-program.txt:104
+            headers['Idempotency-Key'] = opts.idempotencyKey;
+        }
+        const fetchOptions = {
+            method: opts.method,
+            headers,
+            signal: controller.signal,
+        };
+        if (opts.body !== undefined) {
+            fetchOptions.body = bigintSafeStringify(opts.body);
+        }
+        if (this.dispatcher) {
+            fetchOptions['dispatcher'] = this.dispatcher;
+        }
+        let maxConnectionRetries = opts.idempotent ? 0 : 1;
+        let connAttempt = 0;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            try {
+                const response = await this.fetchImpl(url, fetchOptions);
+                clearTimeout(timeoutId);
+                const text = await response.text();
+                return { response, text };
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                const isConnectionError = this._isConnectionError(err);
+                const isAbort = err instanceof Error && err.name === 'AbortError';
+                // Aborted due to our timeout (not network) → not a connection error.
+                if (isAbort && !this._isBeforeAck(err)) {
+                    throw new VivaApiError({
+                        message: `Viva API request timed out after ${timeoutMs}ms`,
+                        cause: err,
+                    });
+                }
+                if ((isConnectionError || isAbort) && !opts.idempotent && connAttempt < maxConnectionRetries) {
+                    // Non-idempotent: one retry on connection-level errors (request not acked).
+                    connAttempt++;
+                    continue;
+                }
+                throw new VivaApiError({
+                    message: isAbort
+                        ? `Viva API request timed out`
+                        : `Viva API network error: ${err instanceof Error ? err.message : String(err)}`,
+                    cause: err,
+                });
+            }
+        }
+    }
+    _buildUrl(path, query) {
+        const base = `${this.apiBaseUrl}${path}`;
+        if (!query)
+            return base;
+        const params = new URLSearchParams();
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined) {
+                params.set(k, String(v));
+            }
+        }
+        const qs = params.toString();
+        return qs ? `${base}?${qs}` : base;
+    }
+    _backoffMs(attempt) {
+        const base = this.backoffsMs[attempt] ?? this.backoffsMs[this.backoffsMs.length - 1] ?? 500;
+        const jitter = base * this.jitterRatio * (Math.random() * 2 - 1);
+        return Math.max(0, Math.round(base + jitter));
+    }
+    _retryAfterMs(response) {
+        const header = response.headers.get('Retry-After');
+        if (!header)
+            return undefined;
+        const seconds = parseFloat(header);
+        if (!isNaN(seconds))
+            return Math.max(0, Math.round(seconds * 1000));
+        // HTTP-date format — try to parse it.
+        const date = new Date(header).getTime();
+        if (!isNaN(date))
+            return Math.max(0, date - this.now());
+        return undefined;
+    }
+    _parseErrorBody(text) {
+        if (!text)
+            return {};
+        try {
+            const parsed = JSON.parse(text);
+            // Viva error response shape observed: { ErrorCode, Message } or similar
+            // TODO(impl): confirm exact Viva error body field names (ErrorCode vs error_code, Message vs message)
+            // @see references/viva-docs/md/isv-partner-program.txt:104
+            const vivaCode = typeof parsed['ErrorCode'] === 'number'
+                ? String(parsed['ErrorCode'])
+                : typeof parsed['errorCode'] === 'number'
+                    ? String(parsed['errorCode'])
+                    : typeof parsed['error'] === 'string'
+                        ? parsed['error']
+                        : undefined;
+            const vivaMessage = typeof parsed['Message'] === 'string'
+                ? parsed['Message']
+                : typeof parsed['message'] === 'string'
+                    ? parsed['message']
+                    : undefined;
+            return { vivaCode, vivaMessage };
+        }
+        catch {
+            return {};
+        }
+    }
+    _isConnectionError(err) {
+        if (!(err instanceof Error))
+            return false;
+        const code = err.code;
+        if (code && CONNECTION_ERROR_CODES.has(code))
+            return true;
+        // undici-specific
+        if (err.message.includes('ECONNRESET') || err.message.includes('ENOTFOUND'))
+            return true;
+        return false;
+    }
+    /**
+     * Heuristic: was the abort triggered before any byte was received?
+     * Since AbortError doesn't carry this info directly, we treat all AbortErrors
+     * from our own timeout as "possibly not acked" — safe for non-idempotent retry.
+     */
+    _isBeforeAck(_err) {
+        return true;
+    }
+    _sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/isv/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/isv/client.ts"],"names":[],"mappings":"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"}

package/dist/isv/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * viva-payments-core/isv — barrel export.
+ *
+ * Subpath: `viva-payments-core/isv`
+ *
+ * Exports the ISV-specific API client classes (Accounts, Webhooks) and the
+ * shared HTTP client. Also re-exports `Payments` and `BasicAuthClient` under
+ * their previous names (`IsvPayments`, `LegacyBasicClient`) as deprecated
+ * aliases for one-minor back-compat — these will be removed in 0.3.0.
+ *
+ * @see references/viva-docs/md/isv-partner-program.txt:104
+ * @see references/viva-docs/md/payment-isv-api.txt:1
+ */
+export { IsvHttpClient } from './client.js';
+export type { IsvHttpClientConfig } from './client.js';
+export { IsvAccounts } from './accounts.js';
+export { IsvWebhooks } from './webhooks-api.js';
+export { IsvSources } from './sources.js';
+export type { CreateEcommerceSourceInput, CreatePhysicalSourceInput, SourceResponse, } from './sources.js';
+import { Payments } from '../payments/index.js';
+import type { IsvHttpClient } from './client.js';
+import { BasicAuthClient } from '../legacy/index.js';
+import type { BasicAuthClientConfig, LegacyApiResult, MerchantBasicAuthClientConfig } from '../legacy/index.js';
+/**
+ * @deprecated Use `Payments` from `@sakeetech/viva-payments-core/payments`
+ * with `mode: 'isv'` explicitly set. Will be removed in 0.3.0.
+ *
+ * Back-compat wrapper that preserves the pre-slice-2 positional constructor
+ * signature and pins `mode: 'isv'` on the underlying {@link Payments} class.
+ * Existing call sites such as `new IsvPayments(client, undefined, legacyClient)`
+ * continue to compile and behave as before.
+ */
+export declare class IsvPayments extends Payments {
+    constructor(client: IsvHttpClient, secondaryClient?: IsvHttpClient, legacyClient?: BasicAuthClient);
+}
+/**
+ * @deprecated Renamed to `BasicAuthClient` — import from
+ * `@sakeetech/viva-payments-core/legacy`. Will be removed in 0.3.0.
+ *
+ * Back-compat wrapper that always pins `authVariant: 'merchant'` on the
+ * underlying {@link BasicAuthClient}. Pre-slice-4 adapter call sites that
+ * construct `LegacyBasicClient` with `{ environment, merchantId, apiKey }`
+ * continue to compile and behave identically.
+ */
+export declare class LegacyBasicClient extends BasicAuthClient {
+    constructor(opts: Omit<MerchantBasicAuthClientConfig, 'authVariant'>);
+}
+/** @deprecated Renamed to `BasicAuthClientConfig` — import from `@sakeetech/viva-payments-core/legacy`. Will be removed in 0.3.0. */
+export type LegacyBasicClientConfig = BasicAuthClientConfig;
+/** @deprecated Import from `@sakeetech/viva-payments-core/legacy`. Will be removed in 0.3.0. */
+export type { LegacyApiResult };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/isv/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,6BAA6B,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;GAQG;AACH,qBAAa,WAAY,SAAQ,QAAQ;gBAErC,MAAM,EAAE,aAAa,EACrB,eAAe,CAAC,EAAE,aAAa,EAC/B,YAAY,CAAC,EAAE,eAAe;CASjC;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,IAAI,EAAE,IAAI,CAAC,6BAA6B,EAAE,aAAa,CAAC;CAGrE;AAED,qIAAqI;AACrI,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE5D,gGAAgG;AAChG,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/isv/index.js

@@ -0,0 +1,53 @@
+/**
+ * viva-payments-core/isv — barrel export.
+ *
+ * Subpath: `viva-payments-core/isv`
+ *
+ * Exports the ISV-specific API client classes (Accounts, Webhooks) and the
+ * shared HTTP client. Also re-exports `Payments` and `BasicAuthClient` under
+ * their previous names (`IsvPayments`, `LegacyBasicClient`) as deprecated
+ * aliases for one-minor back-compat — these will be removed in 0.3.0.
+ *
+ * @see references/viva-docs/md/isv-partner-program.txt:104
+ * @see references/viva-docs/md/payment-isv-api.txt:1
+ */
+export { IsvHttpClient } from './client.js';
+export { IsvAccounts } from './accounts.js';
+export { IsvWebhooks } from './webhooks-api.js';
+export { IsvSources } from './sources.js';
+import { Payments } from '../payments/index.js';
+import { BasicAuthClient } from '../legacy/index.js';
+/**
+ * @deprecated Use `Payments` from `@sakeetech/viva-payments-core/payments`
+ * with `mode: 'isv'` explicitly set. Will be removed in 0.3.0.
+ *
+ * Back-compat wrapper that preserves the pre-slice-2 positional constructor
+ * signature and pins `mode: 'isv'` on the underlying {@link Payments} class.
+ * Existing call sites such as `new IsvPayments(client, undefined, legacyClient)`
+ * continue to compile and behave as before.
+ */
+export class IsvPayments extends Payments {
+    constructor(client, secondaryClient, legacyClient) {
+        super({
+            mode: 'isv',
+            client,
+            ...(secondaryClient !== undefined ? { secondaryClient } : {}),
+            ...(legacyClient !== undefined ? { legacyClient } : {}),
+        });
+    }
+}
+/**
+ * @deprecated Renamed to `BasicAuthClient` — import from
+ * `@sakeetech/viva-payments-core/legacy`. Will be removed in 0.3.0.
+ *
+ * Back-compat wrapper that always pins `authVariant: 'merchant'` on the
+ * underlying {@link BasicAuthClient}. Pre-slice-4 adapter call sites that
+ * construct `LegacyBasicClient` with `{ environment, merchantId, apiKey }`
+ * continue to compile and behave identically.
+ */
+export class LegacyBasicClient extends BasicAuthClient {
+    constructor(opts) {
+        super({ authVariant: 'merchant', ...opts });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/isv/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/isv/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAOrD;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAQ;IACvC,YACE,MAAqB,EACrB,eAA+B,EAC/B,YAA8B;QAE9B,KAAK,CAAC;YACJ,IAAI,EAAE,KAAK;YACX,MAAM;YACN,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,YAAY,IAAwD;QAClE,KAAK,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;CACF"}