@spare-technologies/spare-link 0.1.0-beta.0

package/lib/commonjs/ui/widgets/modal-dismiss-button.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ModalDismissButton = ModalDismissButton;
+var _vectorIcons = require("@expo/vector-icons");
+var _reactNative = require("react-native");
+var _index = require("../theme/index.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function ModalDismissButton(props) {
+  if (!props.visible) return null;
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+    style: styles.dismissBar,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+      accessibilityRole: "button",
+      accessibilityLabel: "Close",
+      testID: "spare-link-modal-dismiss",
+      onPress: props.onPress,
+      hitSlop: 16,
+      style: styles.dismissPressable,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_vectorIcons.Ionicons, {
+        name: "close",
+        size: 18,
+        color: _index.Colors.textPrimary
+      })
+    })
+  });
+}
+const styles = _reactNative.StyleSheet.create({
+  dismissBar: {
+    flexDirection: 'row',
+    justifyContent: 'flex-end',
+    paddingHorizontal: 12,
+    paddingTop: 8,
+    paddingBottom: 4
+  },
+  dismissPressable: {
+    width: 32,
+    height: 32,
+    alignItems: 'center',
+    justifyContent: 'center',
+    borderRadius: 16,
+    backgroundColor: _index.Colors.surfaceMuted
+  }
+});
+//# sourceMappingURL=modal-dismiss-button.js.map

package/lib/commonjs/ui/widgets/modal-dismiss-button.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_vectorIcons","require","_reactNative","_index","_jsxRuntime","ModalDismissButton","props","visible","jsx","View","style","styles","dismissBar","children","Pressable","accessibilityRole","accessibilityLabel","testID","onPress","hitSlop","dismissPressable","Ionicons","name","size","color","Colors","textPrimary","StyleSheet","create","flexDirection","justifyContent","paddingHorizontal","paddingTop","paddingBottom","width","height","alignItems","borderRadius","backgroundColor","surfaceMuted"],"sourceRoot":"../../../../src","sources":["ui/widgets/modal-dismiss-button.tsx"],"mappings":";;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,MAAA,GAAAF,OAAA;AAAkC,IAAAG,WAAA,GAAAH,OAAA;AAO3B,SAASI,kBAAkBA,CAACC,KAA8B,EAAsB;EACrF,IAAI,CAACA,KAAK,CAACC,OAAO,EAAE,OAAO,IAAI;EAC/B,oBACE,IAAAH,WAAA,CAAAI,GAAA,EAACN,YAAA,CAAAO,IAAI;IAACC,KAAK,EAAEC,MAAM,CAACC,UAAW;IAAAC,QAAA,eAC7B,IAAAT,WAAA,CAAAI,GAAA,EAACN,YAAA,CAAAY,SAAS;MACRC,iBAAiB,EAAC,QAAQ;MAC1BC,kBAAkB,EAAC,OAAO;MAC1BC,MAAM,EAAC,0BAA0B;MACjCC,OAAO,EAAEZ,KAAK,CAACY,OAAQ;MACvBC,OAAO,EAAE,EAAG;MACZT,KAAK,EAAEC,MAAM,CAACS,gBAAiB;MAAAP,QAAA,eAE/B,IAAAT,WAAA,CAAAI,GAAA,EAACR,YAAA,CAAAqB,QAAQ;QAACC,IAAI,EAAC,OAAO;QAACC,IAAI,EAAE,EAAG;QAACC,KAAK,EAAEC,aAAM,CAACC;MAAY,CAAE;IAAC,CACrD;EAAC,CACR,CAAC;AAEX;AAEA,MAAMf,MAAM,GAAGgB,uBAAU,CAACC,MAAM,CAAC;EAC/BhB,UAAU,EAAE;IACViB,aAAa,EAAE,KAAK;IACpBC,cAAc,EAAE,UAAU;IAC1BC,iBAAiB,EAAE,EAAE;IACrBC,UAAU,EAAE,CAAC;IACbC,aAAa,EAAE;EACjB,CAAC;EACDb,gBAAgB,EAAE;IAChBc,KAAK,EAAE,EAAE;IACTC,MAAM,EAAE,EAAE;IACVC,UAAU,EAAE,QAAQ;IACpBN,cAAc,EAAE,QAAQ;IACxBO,YAAY,EAAE,EAAE;IAChBC,eAAe,EAAEb,aAAM,CAACc;EAC1B;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/commonjs/ui/widgets/stepper.js

@@ -0,0 +1,124 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CustomStepper = CustomStepper;
+var _reactNative = require("react-native");
+var _index = require("../theme/index.js");
+var _jsxRuntime = require("react/jsx-runtime");
+const TOTAL_STEPS = 3;
+const STEP_LABELS = ['Consent', 'Authorize', 'Complete'];
+/**
+ * Three-step progress indicator. Port of Flutter `CustomStepper`
+ * (`lib/src/ui/widgets/stepper.dart`): a grey baseline with a black fill up to
+ * the current step, numbered circles, and "Consent / Authorize / Complete"
+ * labels.
+ */
+function CustomStepper(props) {
+  const maxProgress = TOTAL_STEPS - 1;
+  const progressPercent = Math.min(1, Math.max(0, props.progress / maxProgress));
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    testID: "custom-stepper",
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: styles.track,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+        style: styles.lineArea,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          style: styles.baseline
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          style: [styles.fill, {
+            width: `${progressPercent * 100}%`
+          }]
+        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          style: styles.circlesRow,
+          children: STEP_LABELS.map((label, index) => {
+            const isFilled = props.progress >= index;
+            return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+              testID: `stepper-circle-${index}`,
+              style: [styles.circle, isFilled ? styles.circleFilled : styles.circleEmpty],
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+                style: [styles.circleText, isFilled && styles.circleTextFilled],
+                children: index + 1
+              })
+            }, label);
+          })
+        })]
+      })
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: styles.labelsRow,
+      children: STEP_LABELS.map(label => /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: styles.label,
+        children: label
+      }, label))
+    })]
+  });
+}
+const LINE_COLOR_BG = '#D6D6DB'; // Colors.grey.shade300
+const CIRCLE_SIZE = 32;
+const styles = _reactNative.StyleSheet.create({
+  track: {
+    height: 40,
+    justifyContent: 'center',
+    paddingHorizontal: 12
+  },
+  // Inset content box (track width − 24). The baseline and the percent-width
+  // fill are positioned relative to this, so they share one reference span.
+  lineArea: {
+    justifyContent: 'center'
+  },
+  baseline: {
+    position: 'absolute',
+    left: 0,
+    right: 0,
+    top: 18,
+    height: 4,
+    backgroundColor: LINE_COLOR_BG
+  },
+  fill: {
+    position: 'absolute',
+    left: 0,
+    top: 18,
+    height: 4,
+    backgroundColor: '#000000',
+    borderTopRightRadius: 12,
+    borderBottomRightRadius: 12
+  },
+  circlesRow: {
+    flexDirection: 'row',
+    justifyContent: 'space-between',
+    alignItems: 'center'
+  },
+  circle: {
+    width: CIRCLE_SIZE,
+    height: CIRCLE_SIZE,
+    borderRadius: CIRCLE_SIZE / 2,
+    alignItems: 'center',
+    justifyContent: 'center'
+  },
+  circleFilled: {
+    backgroundColor: '#000000'
+  },
+  circleEmpty: {
+    backgroundColor: LINE_COLOR_BG
+  },
+  circleText: {
+    fontFamily: _index.FONT_FAMILY,
+    fontWeight: '700',
+    color: '#000000'
+  },
+  circleTextFilled: {
+    color: '#FFFFFF'
+  },
+  labelsRow: {
+    flexDirection: 'row',
+    justifyContent: 'space-between',
+    marginTop: 4
+  },
+  label: {
+    fontFamily: _index.FONT_FAMILY,
+    fontSize: 14,
+    color: '#000000'
+  }
+});
+//# sourceMappingURL=stepper.js.map

package/lib/commonjs/ui/widgets/stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","_index","_jsxRuntime","TOTAL_STEPS","STEP_LABELS","CustomStepper","props","maxProgress","progressPercent","Math","min","max","progress","jsxs","View","testID","children","jsx","style","styles","track","lineArea","baseline","fill","width","circlesRow","map","label","index","isFilled","circle","circleFilled","circleEmpty","Text","circleText","circleTextFilled","labelsRow","LINE_COLOR_BG","CIRCLE_SIZE","StyleSheet","create","height","justifyContent","paddingHorizontal","position","left","right","top","backgroundColor","borderTopRightRadius","borderBottomRightRadius","flexDirection","alignItems","borderRadius","fontFamily","FONT_FAMILY","fontWeight","color","marginTop","fontSize"],"sourceRoot":"../../../../src","sources":["ui/widgets/stepper.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/version.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SDK_VERSION = void 0;
+/**
+ * SDK version reported in telemetry and the default User-Agent. This file is
+ * regenerated from `package.json` by the root `version` npm script on every
+ * release bump (see the `version` script in the repo-root package.json), so it
+ * always matches the published version — do not edit the literal by hand.
+ */
+const SDK_VERSION = exports.SDK_VERSION = '0.1.0-beta.0';
+//# sourceMappingURL=version.js.map

package/lib/commonjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SDK_VERSION","exports"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,WAAW,GAAAC,OAAA,CAAAD,WAAA,GAAG,cAAuB","ignoreList":[]}

package/lib/module/core/client/link-api-client.js

@@ -0,0 +1,292 @@
+"use strict";
+
+import { createLogger } from "../../internal/logger.js";
+import { DEFAULT_REQUEST_TIMEOUT_MS } from "../../public/constants.js";
+import { tenantCountryCode } from "../../public/spare-link-config.js";
+import { SDK_VERSION } from "../../version.js";
+import { PaymentApiError, isPaymentApiError } from "../errors/payment-api-error.js";
+import { mapConsentResponse, mapCopResponse, mapLinkSessionResponse, mapLinkStatusResponse, mapPatchTokenResponse, mapProvidersResponse, mapTelemetryResponse, unwrap } from "../models/wire-mappers.js";
+const RETRYABLE_ERROR_CODES = new Set(['network_timeout', 'consent_creation_failed', 'bank_unavailable', 'network_error']);
+const DEFAULT_USER_AGENT = `@spare-technologies/spare-link/${SDK_VERSION}`;
+const log = createLogger('LinkApiClient');
+function isCryptoCapable(g) {
+  return typeof g.crypto !== 'undefined' && typeof g.crypto.randomUUID === 'function';
+}
+function isCryptoRandom(g) {
+  return typeof g.crypto !== 'undefined' && typeof g.crypto.getRandomValues === 'function';
+}
+function defaultUuid() {
+  if (isCryptoCapable(globalThis)) {
+    return globalThis.crypto.randomUUID();
+  }
+  const bytes = new Uint8Array(16);
+  if (isCryptoRandom(globalThis)) {
+    globalThis.crypto.getRandomValues(bytes);
+  } else {
+    for (let i = 0; i < 16; i += 1) bytes[i] = Math.floor(Math.random() * 256);
+  }
+  bytes[6] = (bytes[6] ?? 0) & 0x0f | 0x40;
+  bytes[8] = (bytes[8] ?? 0) & 0x3f | 0x80;
+  const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+}
+
+/** Full client for all Link-origin endpoints — headers, retry rules, and error mapping. */
+export class LinkApiClient {
+  aborters = new Set();
+  disposed = false;
+  constructor(opts) {
+    this.baseUrl = opts.baseUrl.endsWith('/') ? opts.baseUrl.slice(0, -1) : opts.baseUrl;
+    this.tenantHeader = typeof opts.tenant === 'string' && /^[A-Z]+$/.test(opts.tenant) ? opts.tenant : tenantCountryCode(opts.tenant);
+    this.requestTimeoutMs = opts.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    this.fetchImpl = opts.fetch ?? globalThis.fetch.bind(globalThis);
+    this.uuid = opts.uuid ?? defaultUuid;
+    this.userAgent = opts.userAgent ?? DEFAULT_USER_AGENT;
+  }
+
+  /** Aborts in-flight requests and rejects further work. */
+  dispose() {
+    this.disposed = true;
+    for (const c of this.aborters) c.abort();
+    this.aborters.clear();
+  }
+  headers(linkToken, extra) {
+    return {
+      'x-link-token': linkToken,
+      'Content-Type': 'application/json',
+      'X-Tenant': this.tenantHeader,
+      'User-Agent': this.userAgent,
+      ...(extra ?? {})
+    };
+  }
+  url(path) {
+    return `${this.baseUrl}${path.startsWith('/') ? path : `/${path}`}`;
+  }
+
+  /**
+   * Wraps a single attempt with a per-request `AbortController`. Times out after
+   * `requestTimeoutMs`. Classifies any thrown non-{@link PaymentApiError} as
+   * `network_error` so callers always see a typed error.
+   */
+  async withTimeout(body) {
+    if (this.disposed) {
+      throw new PaymentApiError('client_disposed', 'API client has been disposed.');
+    }
+    const controller = new AbortController();
+    this.aborters.add(controller);
+    const timer = setTimeout(() => controller.abort(), this.requestTimeoutMs);
+    try {
+      return await body(controller.signal);
+    } catch (err) {
+      if (isPaymentApiError(err)) throw err;
+      const name = err.name;
+      if (name === 'AbortError') {
+        log.severe(`request timed out after ${this.requestTimeoutMs}ms${this.disposed ? ' (client disposed)' : ''}`);
+        throw new PaymentApiError(this.disposed ? 'client_disposed' : 'network_timeout', this.disposed ? 'API client was disposed mid-request.' : 'The request timed out. Please check your connection and try again.');
+      }
+      // Catch-all: DNS, refused, malformed response, JSON parse failure, etc.
+      // We surface the message for debugging but a stable code for branching.
+      const message = err instanceof Error ? err.message : String(err);
+      throw new PaymentApiError('network_error', `Network error: ${message}`);
+    } finally {
+      clearTimeout(timer);
+      this.aborters.delete(controller);
+    }
+  }
+
+  /** Idempotent retry helper (max 2 attempts, 500ms + 1000ms backoff). */
+  async withRetry(body, maxAttempts = 2) {
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+      try {
+        return await this.withTimeout(body);
+      } catch (err) {
+        if (isPaymentApiError(err) && RETRYABLE_ERROR_CODES.has(err.code) && attempt < maxAttempts) {
+          lastError = err;
+          await delay(attempt === 1 ? 500 : 1000);
+          continue;
+        }
+        throw err;
+      }
+    }
+    throw lastError ?? new PaymentApiError('network_error', 'A network error occurred. Please try again.');
+  }
+  async parseAndHandle(res, mapper, endpoint) {
+    if (!res.ok) {
+      await this.throwForError(res);
+    }
+    let body;
+    try {
+      body = await res.json();
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      throw new PaymentApiError(`${endpoint}_payload_invalid`, `${endpoint} response body is not valid JSON: ${message}`);
+    }
+    try {
+      return mapper(unwrap(body));
+    } catch (err) {
+      if (isPaymentApiError(err)) throw err;
+      const message = err instanceof Error ? err.message : String(err);
+      throw new PaymentApiError(`${endpoint}_payload_invalid`, `${endpoint} response payload is invalid: ${message}`);
+    }
+  }
+  async throwForError(res) {
+    const text = await res.text().catch(() => '');
+    let parsed;
+    try {
+      parsed = text ? JSON.parse(text) : undefined;
+    } catch {
+      parsed = undefined;
+    }
+    const errorCode = parsed?.error_code ?? parsed?.code ?? (typeof parsed?.error === 'string' ? parsed.error : undefined);
+    switch (res.status) {
+      case 401:
+        log.severe('HTTP 401: link token invalid or expired');
+        throw new PaymentApiError('invalid_token', 'The link token is invalid or has expired.');
+      case 410:
+        if (errorCode === 'SESSION_CANCELLED') {
+          log.severe('HTTP 410: session cancelled');
+          throw new PaymentApiError('session_cancelled', 'The payment session was cancelled.');
+        }
+        log.severe('HTTP 410: session expired');
+        throw PaymentApiError.sessionExpired();
+      case 409:
+        log.severe('HTTP 409: session already completed');
+        throw new PaymentApiError('session_already_completed', 'The payment session has already been completed.');
+      case 503:
+        log.severe('HTTP 503: bank unavailable');
+        throw new PaymentApiError('bank_unavailable', 'Bank is temporarily unavailable. Please try again.');
+      case 502:
+        log.severe('HTTP 502: consent creation failed');
+        throw new PaymentApiError('consent_creation_failed', 'Unable to create payment authorization. Please try again.');
+      case 408:
+        log.severe('HTTP 408: request timeout');
+        throw new PaymentApiError('network_timeout', 'The server timed out processing the request. Please try again.');
+      case 429:
+        log.severe('HTTP 429: rate limit exceeded');
+        throw new PaymentApiError('rate_limit_exceeded', 'Too many requests. Please wait and try again.');
+      default:
+        log.severe(`HTTP ${res.status}: unexpected error`);
+        throw new PaymentApiError('network_error', `Unexpected status ${res.status} from Link API.`);
+    }
+  }
+
+  // ---- Endpoints ----------------------------------------------------------
+
+  /** `GET /link` — one-time session hydration. */
+  async getSession(linkToken) {
+    log.info('GET /link');
+    return this.withRetry(async signal => {
+      const res = await this.fetchImpl(this.url('/link'), {
+        method: 'GET',
+        headers: this.headers(linkToken),
+        signal
+      });
+      return this.parseAndHandle(res, mapLinkSessionResponse, 'session');
+    });
+  }
+
+  /** `GET /link/status` — read-only session status. */
+  async getStatus(linkToken) {
+    log.info('GET /link/status');
+    return this.withRetry(async signal => {
+      const res = await this.fetchImpl(this.url('/link/status'), {
+        method: 'GET',
+        headers: this.headers(linkToken),
+        signal
+      });
+      return this.parseAndHandle(res, mapLinkStatusResponse, 'status');
+    });
+  }
+
+  /** `GET /link/providers` — bank list for the session jurisdiction. */
+  async getProviders(linkToken) {
+    log.info('GET /link/providers');
+    return this.withRetry(async signal => {
+      const res = await this.fetchImpl(this.url('/link/providers'), {
+        method: 'GET',
+        headers: this.headers(linkToken),
+        signal
+      });
+      return this.parseAndHandle(res, mapProvidersResponse, 'providers');
+    });
+  }
+
+  /** `POST /link/telemetry` — device/risk signals (best-effort). */
+  async postTelemetry(args) {
+    log.info('POST /link/telemetry');
+    return this.withRetry(async signal => {
+      const res = await this.fetchImpl(this.url('/link/telemetry'), {
+        method: 'POST',
+        headers: this.headers(args.linkToken),
+        body: JSON.stringify(args.payload),
+        signal
+      });
+      return this.parseAndHandle(res, mapTelemetryResponse, 'telemetry');
+    });
+  }
+
+  /** `GET /link/cop` — Confirmation of Payee. Accepts an optional providerId override. */
+  async getConfirmPayee(linkToken, providerId) {
+    log.info(`GET /link/cop${providerId ? ` (providerId: ${providerId})` : ''}`);
+    return this.withRetry(async signal => {
+      const path = providerId ? `/link/cop?providerId=${encodeURIComponent(providerId)}` : '/link/cop';
+      const res = await this.fetchImpl(this.url(path), {
+        method: 'GET',
+        headers: this.headers(linkToken),
+        signal
+      });
+      return this.parseAndHandle(res, mapCopResponse, 'cop');
+    });
+  }
+
+  /**
+   * `POST /link/consent` — creates a consent and returns the bank redirect URL.
+   *
+   * NEVER retried — the Idempotency-Key header guarantees safe retries at the
+   * caller level if they re-invoke with the SAME key.
+   */
+  async postConsent(args) {
+    const key = args.idempotencyKey ?? this.uuid();
+    log.info(`POST /link/consent (bankId: ${args.bankId ?? 'n/a'}, idempotencyKey: ${key})`);
+    return this.withTimeout(async signal => {
+      const body = args.bankId ? JSON.stringify({
+        provider_id: args.bankId
+      }) : '{}';
+      const res = await this.fetchImpl(this.url('/link/consent'), {
+        method: 'POST',
+        headers: this.headers(args.linkToken, {
+          'Idempotency-Key': key
+        }),
+        body,
+        signal
+      });
+      return this.parseAndHandle(res, mapConsentResponse, 'consent');
+    });
+  }
+
+  /** `PATCH /link` — cancel or report an error on the session. */
+  async patchToken(args) {
+    log.info(`PATCH /link (action: ${args.action}, errorCode: ${args.errorCode ?? 'n/a'})`);
+    return this.withRetry(async signal => {
+      const body = {
+        action: args.action
+      };
+      if (args.errorCode) body.code = args.errorCode;
+      // Tag SDK-originated error reports so the backend can distinguish them
+      // from hosted/provider-return reports in its dashboards.
+      if (args.action === 'error') body.source = 'sdk';
+      const res = await this.fetchImpl(this.url('/link'), {
+        method: 'PATCH',
+        headers: this.headers(args.linkToken),
+        body: JSON.stringify(body),
+        signal
+      });
+      return this.parseAndHandle(res, mapPatchTokenResponse, 'patch_token');
+    });
+  }
+}
+function delay(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=link-api-client.js.map

package/lib/module/core/client/link-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createLogger","DEFAULT_REQUEST_TIMEOUT_MS","tenantCountryCode","SDK_VERSION","PaymentApiError","isPaymentApiError","mapConsentResponse","mapCopResponse","mapLinkSessionResponse","mapLinkStatusResponse","mapPatchTokenResponse","mapProvidersResponse","mapTelemetryResponse","unwrap","RETRYABLE_ERROR_CODES","Set","DEFAULT_USER_AGENT","log","isCryptoCapable","g","crypto","randomUUID","isCryptoRandom","getRandomValues","defaultUuid","globalThis","bytes","Uint8Array","i","Math","floor","random","hex","Array","from","b","toString","padStart","join","slice","LinkApiClient","aborters","disposed","constructor","opts","baseUrl","endsWith","tenantHeader","tenant","test","requestTimeoutMs","fetchImpl","fetch","bind","uuid","userAgent","dispose","c","abort","clear","headers","linkToken","extra","url","path","startsWith","withTimeout","body","controller","AbortController","add","timer","setTimeout","signal","err","name","severe","message","Error","String","clearTimeout","delete","withRetry","maxAttempts","lastError","attempt","has","code","delay","parseAndHandle","res","mapper","endpoint","ok","throwForError","json","text","catch","parsed","JSON","parse","undefined","errorCode","error_code","error","status","sessionExpired","getSession","info","method","getStatus","getProviders","postTelemetry","args","stringify","payload","getConfirmPayee","providerId","encodeURIComponent","postConsent","key","idempotencyKey","bankId","provider_id","patchToken","action","source","ms","Promise","resolve"],"sourceRoot":"../../../../src","sources":["core/client/link-api-client.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/errors/payment-api-error.js

@@ -0,0 +1,29 @@
+"use strict";
+
+/**
+ * Errors emitted by the SDK's API client.
+ *
+ * The `code` field is stable wire-of-record for merchant analytics/logging.
+ * The `message` field is intentionally generic and safe to display to end users.
+ */
+export class PaymentApiError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.name = 'PaymentApiError';
+    this.code = code;
+    // Preserve the prototype chain across compile targets.
+    Object.setPrototypeOf(this, PaymentApiError.prototype);
+  }
+  toString() {
+    return `PaymentApiError(${this.code}): ${this.message}`;
+  }
+  static sessionExpired() {
+    return new PaymentApiError('session_expired', 'The payment session has expired.');
+  }
+}
+
+/** Type guard so consumers can narrow without instanceof. */
+export function isPaymentApiError(err) {
+  return err instanceof PaymentApiError || typeof err === 'object' && err !== null && err.name === 'PaymentApiError';
+}
+//# sourceMappingURL=payment-api-error.js.map

package/lib/module/core/errors/payment-api-error.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PaymentApiError","Error","constructor","code","message","name","Object","setPrototypeOf","prototype","toString","sessionExpired","isPaymentApiError","err"],"sourceRoot":"../../../../src","sources":["core/errors/payment-api-error.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,eAAe,SAASC,KAAK,CAAC;EAGzCC,WAAWA,CAACC,IAAY,EAAEC,OAAe,EAAE;IACzC,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,iBAAiB;IAC7B,IAAI,CAACF,IAAI,GAAGA,IAAI;IAChB;IACAG,MAAM,CAACC,cAAc,CAAC,IAAI,EAAEP,eAAe,CAACQ,SAAS,CAAC;EACxD;EAESC,QAAQA,CAAA,EAAW;IAC1B,OAAO,mBAAmB,IAAI,CAACN,IAAI,MAAM,IAAI,CAACC,OAAO,EAAE;EACzD;EAEA,OAAOM,cAAcA,CAAA,EAAoB;IACvC,OAAO,IAAIV,eAAe,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;EACnF;AACF;;AAEA;AACA,OAAO,SAASW,iBAAiBA,CAACC,GAAY,EAA0B;EACtE,OACEA,GAAG,YAAYZ,eAAe,IAC7B,OAAOY,GAAG,KAAK,QAAQ,IACtBA,GAAG,KAAK,IAAI,IACXA,GAAG,CAAuBP,IAAI,KAAK,iBAAkB;AAE5D","ignoreList":[]}

package/lib/module/core/models/index.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=index.js.map

package/lib/module/core/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["core/models/index.ts"],"mappings":"","ignoreList":[]}

package/lib/module/core/models/link-session-status.js

@@ -0,0 +1,10 @@
+"use strict";
+
+/**
+ * `/link/status` values where the bank has returned but settlement may still be
+ * pending. `redirected` only means consent was posted — not bank authorization.
+ */
+export function isBankCallbackReceivedStatus(status) {
+  return status === 'callback_received';
+}
+//# sourceMappingURL=link-session-status.js.map

package/lib/module/core/models/link-session-status.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isBankCallbackReceivedStatus","status"],"sourceRoot":"../../../../src","sources":["core/models/link-session-status.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,SAASA,4BAA4BA,CAACC,MAAc,EAAW;EACpE,OAAOA,MAAM,KAAK,mBAAmB;AACvC","ignoreList":[]}

package/lib/module/core/models/payment-return-params.js

@@ -0,0 +1,37 @@
+"use strict";
+
+/**
+ * Query-parameter helpers for bank / authorize return URIs.
+ *
+ * The Link service appends `exchange_code` on success and `error_code` on
+ * authorize failure (legacy integrations may still send `error`).
+ */
+
+export function isPaymentReturnCallbackUri(uri) {
+  let parsed;
+  try {
+    parsed = typeof uri === 'string' ? new URL(uri) : uri;
+  } catch {
+    return false;
+  }
+  const params = parsed.searchParams;
+  if (params.has('exchange_code')) return true;
+  if (params.has('error_code')) return true;
+  if (params.has('error')) return true;
+  if (params.get('status') === 'failure') return true;
+  return false;
+}
+
+/**
+ * Extract the failure code from a payment-return URI, if present.
+ *
+ * `error_code` takes precedence over the legacy `error` query param. A
+ * `status=failure` with no other code resolves to `'authorize_failed'`.
+ */
+export function extractPaymentReturnErrorCode(params) {
+  const code = params.get('error_code') ?? params.get('error');
+  if (code && code.length > 0) return code;
+  if (params.get('status') === 'failure') return 'authorize_failed';
+  return undefined;
+}
+//# sourceMappingURL=payment-return-params.js.map

package/lib/module/core/models/payment-return-params.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isPaymentReturnCallbackUri","uri","parsed","URL","params","searchParams","has","get","extractPaymentReturnErrorCode","code","length","undefined"],"sourceRoot":"../../../../src","sources":["core/models/payment-return-params.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASA,0BAA0BA,CAACC,GAAiB,EAAW;EACrE,IAAIC,MAAW;EACf,IAAI;IACFA,MAAM,GAAG,OAAOD,GAAG,KAAK,QAAQ,GAAG,IAAIE,GAAG,CAACF,GAAG,CAAC,GAAGA,GAAG;EACvD,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;EACA,MAAMG,MAAM,GAAGF,MAAM,CAACG,YAAY;EAClC,IAAID,MAAM,CAACE,GAAG,CAAC,eAAe,CAAC,EAAE,OAAO,IAAI;EAC5C,IAAIF,MAAM,CAACE,GAAG,CAAC,YAAY,CAAC,EAAE,OAAO,IAAI;EACzC,IAAIF,MAAM,CAACE,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,IAAI;EACpC,IAAIF,MAAM,CAACG,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,OAAO,IAAI;EACnD,OAAO,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,6BAA6BA,CAACJ,MAAuB,EAAsB;EACzF,MAAMK,IAAI,GAAGL,MAAM,CAACG,GAAG,CAAC,YAAY,CAAC,IAAIH,MAAM,CAACG,GAAG,CAAC,OAAO,CAAC;EAC5D,IAAIE,IAAI,IAAIA,IAAI,CAACC,MAAM,GAAG,CAAC,EAAE,OAAOD,IAAI;EACxC,IAAIL,MAAM,CAACG,GAAG,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,OAAO,kBAAkB;EACjE,OAAOI,SAAS;AAClB","ignoreList":[]}