@sakeetech/vendure-payment-viva 0.2.1

package/dist/util/normalize-options.js

@@ -0,0 +1,189 @@
+/**
+ * util/normalize-options.ts — input validation + back-compat handling for
+ * `VivaPaymentPlugin.init()`.
+ *
+ * Takes the loose `VivaPaymentPluginInitInput` shape (which accepts deprecated
+ * field aliases and an optional `mode`) and returns the strict discriminated
+ * `VivaPaymentPluginOptions` union.
+ *
+ * Responsibilities:
+ *  1. Resolve deprecated `isvClientId`/`isvClientSecret` → `clientId`/`clientSecret`,
+ *     with one-time deprecation warnings.
+ *  2. Resolve `mode`: default to `'merchant'` (with a warning), or auto-detect
+ *     `'isv'` when ISV-only fields are present (no warning — strong hint).
+ *  3. Warn (don't throw) when merchant mode is paired with ISV-only resolvers.
+ *  4. Throw a single aggregated error if required fields are missing.
+ *
+ * Mirrors `medusa-payment-viva/src/config.ts` defaulting + back-compat behaviour
+ * (multi-mode-v0 plan §5, §10).
+ */
+import { VivaValidationError } from '@sakeetech/viva-payments-core/errors';
+// ---------------------------------------------------------------------------
+// One-shot warning latches (process-level)
+// ---------------------------------------------------------------------------
+let _isvClientIdAliasWarned = false;
+let _isvClientSecretAliasWarned = false;
+let _defaultModeNoticeShown = false;
+let _merchantWithIsvResolversWarned = false;
+/** @internal Test-only: reset all one-time warning latches. */
+export function _resetInitNoticesForTesting() {
+    _isvClientIdAliasWarned = false;
+    _isvClientSecretAliasWarned = false;
+    _defaultModeNoticeShown = false;
+    _merchantWithIsvResolversWarned = false;
+}
+// ---------------------------------------------------------------------------
+// Normalizer
+// ---------------------------------------------------------------------------
+const ISV_ONLY_KEYS = [
+    'resolveMerchantId',
+    'resolveSourceCode',
+    'resolveIsvAmount',
+    'resolveCheckoutColor',
+    'onboardingReturnUrl',
+    'onboardingBranding',
+    'reseller',
+];
+const MERCHANT_ONLY_KEYS = [
+    'sourceCode',
+    'checkoutColor',
+];
+export function normalizePluginOptions(input) {
+    const errors = [];
+    // -------------------------------------------------------------------------
+    // 1. clientId / clientSecret — accept deprecated aliases.
+    // -------------------------------------------------------------------------
+    let clientId = input.clientId;
+    if (!clientId && input.isvClientId) {
+        clientId = input.isvClientId;
+        if (!_isvClientIdAliasWarned) {
+            _isvClientIdAliasWarned = true;
+            console.warn('[viva] `isvClientId` is deprecated, rename to `clientId`. ' +
+                'Removal in 0.3.0.');
+        }
+    }
+    if (!clientId) {
+        errors.push('clientId is required');
+    }
+    let clientSecret = input.clientSecret;
+    if (!clientSecret && input.isvClientSecret) {
+        clientSecret = input.isvClientSecret;
+        if (!_isvClientSecretAliasWarned) {
+            _isvClientSecretAliasWarned = true;
+            console.warn('[viva] `isvClientSecret` is deprecated, rename to `clientSecret`. ' +
+                'Removal in 0.3.0.');
+        }
+    }
+    if (!clientSecret) {
+        errors.push('clientSecret is required');
+    }
+    // -------------------------------------------------------------------------
+    // 2. Resolve mode (with auto-detect + default warning).
+    // -------------------------------------------------------------------------
+    const isvFieldsPresent = ISV_ONLY_KEYS.some((k) => input[k] !== undefined);
+    let mode;
+    if (input.mode === 'merchant' || input.mode === 'isv') {
+        mode = input.mode;
+    }
+    else if (input.mode === undefined) {
+        mode = isvFieldsPresent ? 'isv' : 'merchant';
+        if (!isvFieldsPresent && !_defaultModeNoticeShown) {
+            _defaultModeNoticeShown = true;
+            console.warn(`[viva] mode is unset — defaulting to 'merchant'. ` +
+                `Pass mode: 'isv' if running under an ISV partner.`);
+        }
+    }
+    else {
+        errors.push(`mode must be 'merchant' or 'isv', got '${String(input.mode)}'`);
+        mode = 'merchant'; // placeholder
+    }
+    // -------------------------------------------------------------------------
+    // 3. Warn when merchant mode is paired with ISV-only resolvers/fields.
+    // -------------------------------------------------------------------------
+    if (mode === 'merchant' && isvFieldsPresent && !_merchantWithIsvResolversWarned) {
+        const presentKeys = ISV_ONLY_KEYS.filter((k) => input[k] !== undefined);
+        _merchantWithIsvResolversWarned = true;
+        console.warn(`[viva] mode='merchant' but ISV-only field(s) supplied: ${presentKeys.join(', ')}. ` +
+            `These values are ignored in merchant mode.`);
+    }
+    // -------------------------------------------------------------------------
+    // 4. Required common fields.
+    // -------------------------------------------------------------------------
+    if (!input.environment) {
+        errors.push('environment is required');
+    }
+    if (!input.legacyMerchantId) {
+        errors.push('legacyMerchantId is required — needed for createRefund (Viva legacy Basic-auth API).');
+    }
+    if (!input.legacyApiKey) {
+        errors.push('legacyApiKey is required — needed for createRefund (Viva legacy Basic-auth API).');
+    }
+    if (!input.webhookVerificationKey) {
+        errors.push('webhookVerificationKey is required');
+    }
+    if (input.successUrl === undefined) {
+        errors.push('successUrl is required');
+    }
+    if (input.failureUrl === undefined) {
+        errors.push('failureUrl is required');
+    }
+    // ISV mode: onboardingReturnUrl required (Viva ISV API rejects without it).
+    if (mode === 'isv' && input.onboardingReturnUrl === undefined) {
+        errors.push("onboardingReturnUrl is required when mode='isv' " +
+            '(POST /isv/v1/accounts rejects requests without it).');
+    }
+    // -------------------------------------------------------------------------
+    // 5. Throw aggregated validation errors before composing.
+    // -------------------------------------------------------------------------
+    if (errors.length > 0) {
+        throw new VivaValidationError({
+            message: `Invalid Viva plugin options:\n  ${errors.join('\n  ')}`,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // 6. Compose common fields (we've already validated everything above —
+    // the non-null assertions are safe here).
+    // -------------------------------------------------------------------------
+    const common = {
+        environment: input.environment,
+        clientId: clientId,
+        clientSecret: clientSecret,
+        legacyMerchantId: input.legacyMerchantId,
+        legacyApiKey: input.legacyApiKey,
+        webhookVerificationKey: input.webhookVerificationKey,
+        successUrl: input.successUrl,
+        failureUrl: input.failureUrl,
+        ...(input.refundStrategy !== undefined ? { refundStrategy: input.refundStrategy } : {}),
+        ...(input.redlock !== undefined ? { redlock: input.redlock } : {}),
+        ...(input.logger !== undefined ? { logger: input.logger } : {}),
+        ...(input.metricsHook !== undefined ? { metricsHook: input.metricsHook } : {}),
+        ...(input.tracer !== undefined ? { tracer: input.tracer } : {}),
+        ...(input.webhookIpAllowlist !== undefined ? { webhookIpAllowlist: input.webhookIpAllowlist } : {}),
+        ...(input.trustedProxyDepth !== undefined ? { trustedProxyDepth: input.trustedProxyDepth } : {}),
+    };
+    if (mode === 'merchant') {
+        const merchant = {
+            ...common,
+            mode: 'merchant',
+            ...(input.sourceCode !== undefined ? { sourceCode: input.sourceCode } : {}),
+            ...(input.checkoutColor !== undefined ? { checkoutColor: input.checkoutColor } : {}),
+        };
+        return merchant;
+    }
+    // mode === 'isv'
+    const isv = {
+        ...common,
+        mode: 'isv',
+        onboardingReturnUrl: input.onboardingReturnUrl,
+        ...(input.resolveMerchantId !== undefined ? { resolveMerchantId: input.resolveMerchantId } : {}),
+        ...(input.resolveSourceCode !== undefined ? { resolveSourceCode: input.resolveSourceCode } : {}),
+        ...(input.resolveIsvAmount !== undefined ? { resolveIsvAmount: input.resolveIsvAmount } : {}),
+        ...(input.resolveCheckoutColor !== undefined ? { resolveCheckoutColor: input.resolveCheckoutColor } : {}),
+        ...(input.onboardingBranding !== undefined ? { onboardingBranding: input.onboardingBranding } : {}),
+        ...(input.reseller !== undefined ? { reseller: input.reseller } : {}),
+    };
+    // Suppress unused-key warnings for merchant-only fields under ISV mode.
+    void MERCHANT_ONLY_KEYS;
+    return isv;
+}
+//# sourceMappingURL=normalize-options.js.map

package/dist/util/normalize-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-options.js","sourceRoot":"","sources":["../../src/util/normalize-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAS3E,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAE9E,IAAI,uBAAuB,GAAG,KAAK,CAAC;AACpC,IAAI,2BAA2B,GAAG,KAAK,CAAC;AACxC,IAAI,uBAAuB,GAAG,KAAK,CAAC;AACpC,IAAI,+BAA+B,GAAG,KAAK,CAAC;AAE5C,+DAA+D;AAC/D,MAAM,UAAU,2BAA2B;IACzC,uBAAuB,GAAG,KAAK,CAAC;IAChC,2BAA2B,GAAG,KAAK,CAAC;IACpC,uBAAuB,GAAG,KAAK,CAAC;IAChC,+BAA+B,GAAG,KAAK,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,aAAa,GAAoD;IACrE,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,sBAAsB;IACtB,qBAAqB;IACrB,oBAAoB;IACpB,UAAU;CACX,CAAC;AAEF,MAAM,kBAAkB,GAAoD;IAC1E,YAAY;IACZ,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,sBAAsB,CACpC,KAAiC;IAEjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,4EAA4E;IAC5E,0DAA0D;IAC1D,4EAA4E;IAC5E,IAAI,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC9B,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACnC,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC;QAC7B,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,uBAAuB,GAAG,IAAI,CAAC;YAC/B,OAAO,CAAC,IAAI,CACV,4DAA4D;gBAC1D,mBAAmB,CACtB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACtC,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3C,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC;QACrC,IAAI,CAAC,2BAA2B,EAAE,CAAC;YACjC,2BAA2B,GAAG,IAAI,CAAC;YACnC,OAAO,CAAC,IAAI,CACV,oEAAoE;gBAClE,mBAAmB,CACtB,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;IAED,4EAA4E;IAC5E,wDAAwD;IACxD,4EAA4E;IAC5E,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAE3E,IAAI,IAAc,CAAC;IACnB,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACtD,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;QAC7C,IAAI,CAAC,gBAAgB,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAClD,uBAAuB,GAAG,IAAI,CAAC;YAC/B,OAAO,CAAC,IAAI,CACV,mDAAmD;gBACjD,mDAAmD,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7E,IAAI,GAAG,UAAU,CAAC,CAAC,cAAc;IACnC,CAAC;IAED,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,IAAI,IAAI,KAAK,UAAU,IAAI,gBAAgB,IAAI,CAAC,+BAA+B,EAAE,CAAC;QAChF,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QACxE,+BAA+B,GAAG,IAAI,CAAC;QACvC,OAAO,CAAC,IAAI,CACV,0DAA0D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAClF,4CAA4C,CAC/C,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,6BAA6B;IAC7B,4EAA4E;IAC5E,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CACT,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CACT,kFAAkF,CACnF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,sBAAsB,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,4EAA4E;IAC5E,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CACT,kDAAkD;YAChD,sDAAsD,CACzD,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,0DAA0D;IAC1D,4EAA4E;IAC5E,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,mBAAmB,CAAC;YAC5B,OAAO,EAAE,mCAAmC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;SAClE,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,uEAAuE;IACvE,0CAA0C;IAC1C,4EAA4E;IAC5E,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,KAAK,CAAC,WAAY;QAC/B,QAAQ,EAAE,QAAS;QACnB,YAAY,EAAE,YAAa;QAC3B,gBAAgB,EAAE,KAAK,CAAC,gBAAiB;QACzC,YAAY,EAAE,KAAK,CAAC,YAAa;QACjC,sBAAsB,EAAE,KAAK,CAAC,sBAAuB;QACrD,UAAU,EAAE,KAAK,CAAC,UAAW;QAC7B,UAAU,EAAE,KAAK,CAAC,UAAW;QAC7B,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnG,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjG,CAAC;IAEF,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAwB;YACpC,GAAG,MAAM;YACT,IAAI,EAAE,UAAU;YAChB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrF,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iBAAiB;IACjB,MAAM,GAAG,GAAmB;QAC1B,GAAG,MAAM;QACT,IAAI,EAAE,KAAK;QACX,mBAAmB,EAAE,KAAK,CAAC,mBAAoB;QAC/C,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,GAAG,CAAC,KAAK,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,KAAK,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,GAAG,CAAC,KAAK,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnG,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtE,CAAC;IACF,wEAAwE;IACxE,KAAK,kBAAkB,CAAC;IACxB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/util/url-template.d.ts

@@ -0,0 +1,18 @@
+/**
+ * url-template.ts — Simple {token} substitution for redirect URLs.
+ *
+ * Used to substitute {orderCode} (and optionally other tokens) into
+ * successUrl / failureUrl after Viva returns the orderCode.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Configuration Surface"
+ */
+/**
+ * Replace all `{token}` occurrences in a template string with values from
+ * the provided map. Tokens with no matching key are left unchanged.
+ *
+ * @example
+ * substitute('https://example.com/success?ref={orderCode}', { orderCode: '12345' })
+ * // → 'https://example.com/success?ref=12345'
+ */
+export declare function substitute(template: string, tokens: Record<string, string>): string;
+//# sourceMappingURL=url-template.d.ts.map

package/dist/util/url-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-template.d.ts","sourceRoot":"","sources":["../../src/util/url-template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAInF"}

package/dist/util/url-template.js

@@ -0,0 +1,22 @@
+/**
+ * url-template.ts — Simple {token} substitution for redirect URLs.
+ *
+ * Used to substitute {orderCode} (and optionally other tokens) into
+ * successUrl / failureUrl after Viva returns the orderCode.
+ *
+ * @see docs/plans/vendure-plugin-v0.md §"Configuration Surface"
+ */
+/**
+ * Replace all `{token}` occurrences in a template string with values from
+ * the provided map. Tokens with no matching key are left unchanged.
+ *
+ * @example
+ * substitute('https://example.com/success?ref={orderCode}', { orderCode: '12345' })
+ * // → 'https://example.com/success?ref=12345'
+ */
+export function substitute(template, tokens) {
+    return template.replace(/\{([^}]+)\}/g, (match, key) => {
+        return Object.prototype.hasOwnProperty.call(tokens, key) ? tokens[key] : match;
+    });
+}
+//# sourceMappingURL=url-template.js.map

package/dist/util/url-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-template.js","sourceRoot":"","sources":["../../src/util/url-template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,MAA8B;IACzE,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QAC7D,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@sakeetech/vendure-payment-viva",
+  "version": "0.2.1",
+  "description": "Vendure plugin for Viva Wallet (ISV multi-tenant). Wraps viva-payments-core.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sakee-tech/vivawallet-npm-public.git",
+    "directory": "packages/vendure-payment-viva"
+  },
+  "homepage": "https://github.com/sakee-tech/vivawallet-npm-public/tree/main/packages/vendure-payment-viva#readme",
+  "bugs": {
+    "url": "https://github.com/sakee-tech/vivawallet-npm-public/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "vendure-viva-register-webhooks": "./dist/cli/bin.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "bullmq": "^5.76.2",
+    "@sakeetech/viva-payments-core": "0.2.1"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@vendure/core": "^3.6.2",
+    "@vendure/job-queue-plugin": "^3.6.2",
+    "graphql": "^16.0.0",
+    "rxjs": "^7.0.0",
+    "typeorm": "^0.3.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.1.19",
+    "@nestjs/core": "^11.1.19",
+    "@nestjs/graphql": "13.1.0",
+    "@types/node": "^22.10.0",
+    "@types/pg": "^8.11.0",
+    "@vendure/core": "^3.6.2",
+    "@vendure/job-queue-plugin": "^3.6.2",
+    "@vendure/testing": "^3.6.2",
+    "graphql": "^16.13.2",
+    "pg": "^8.13.3",
+    "rxjs": "^7.8.2",
+    "typeorm": "^0.3.28",
+    "typescript": "^5.7.2",
+    "undici": "^7.2.0",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist .tsbuildinfo coverage"
+  }
+}