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

package/lib/module/public/constants.js

@@ -0,0 +1,17 @@
+"use strict";
+
+/**
+ * Max non-terminal `resumeIfNeeded` recovery attempts before the SDK gives up
+ * and resolves the flow as failed with code `recovery_exhausted`.
+ */
+export const kMaxRecoveryAttempts = 3;
+
+/** Default per-request HTTP timeout in milliseconds (15s). */
+export const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;
+
+/** How long the SDK waits for a bank callback before auto-failing with `session_timeout`. */
+export const DEFAULT_AWAITING_CALLBACK_TIMEOUT_MS = 5 * 60 * 1000;
+
+/** Polling interval while the flow is in awaitingCallback (status endpoint). */
+export const DEFAULT_AWAITING_CALLBACK_POLL_MS = 10_000;
+//# sourceMappingURL=constants.js.map

package/lib/module/public/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["kMaxRecoveryAttempts","DEFAULT_REQUEST_TIMEOUT_MS","DEFAULT_AWAITING_CALLBACK_TIMEOUT_MS","DEFAULT_AWAITING_CALLBACK_POLL_MS"],"sourceRoot":"../../../src","sources":["public/constants.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,MAAMA,oBAAoB,GAAG,CAAU;;AAE9C;AACA,OAAO,MAAMC,0BAA0B,GAAG,MAAe;;AAEzD;AACA,OAAO,MAAMC,oCAAoC,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI;;AAEjE;AACA,OAAO,MAAMC,iCAAiC,GAAG,MAAM","ignoreList":[]}

package/lib/module/public/index.js

@@ -0,0 +1,11 @@
+"use strict";
+
+export { defaultBaseUrlFor, tenantCountryCode, resolvedBaseUrl, resolvedResumeBaseUrl, assertValidConfig } from "./spare-link-config.js";
+export { SPARE_LINK_EVENT_TYPES, isSpareLinkEvent, SpareLinkEvents } from "./spare-link-event.js";
+export { paymentSuccess, paymentCancelled, paymentFailed, paymentAbandoned } from "./payment-result.js";
+export { isSessionRecovered, isNoRecoveryNeeded, isRecoveryAwaitingUser } from "./recovery-result.js";
+export { SpareLinkSession } from "./spare-link-session.js";
+export { SpareLink } from "./spare-link-instance.js";
+export { kMaxRecoveryAttempts, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_AWAITING_CALLBACK_TIMEOUT_MS, DEFAULT_AWAITING_CALLBACK_POLL_MS } from "./constants.js";
+export { configureSpareLinkLogging, createLogger } from "../internal/logger.js";
+//# sourceMappingURL=index.js.map

package/lib/module/public/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defaultBaseUrlFor","tenantCountryCode","resolvedBaseUrl","resolvedResumeBaseUrl","assertValidConfig","SPARE_LINK_EVENT_TYPES","isSpareLinkEvent","SpareLinkEvents","paymentSuccess","paymentCancelled","paymentFailed","paymentAbandoned","isSessionRecovered","isNoRecoveryNeeded","isRecoveryAwaitingUser","SpareLinkSession","SpareLink","kMaxRecoveryAttempts","DEFAULT_REQUEST_TIMEOUT_MS","DEFAULT_AWAITING_CALLBACK_TIMEOUT_MS","DEFAULT_AWAITING_CALLBACK_POLL_MS","configureSpareLinkLogging","createLogger"],"sourceRoot":"../../../src","sources":["public/index.ts"],"mappings":";;AAAA,SAKEA,iBAAiB,EACjBC,iBAAiB,EACjBC,eAAe,EACfC,qBAAqB,EACrBC,iBAAiB,QACZ,wBAAqB;AAE5B,SAYEC,sBAAsB,EACtBC,gBAAgB,EAChBC,eAAe,QACV,uBAAoB;AAE3B,SAOEC,cAAc,EACdC,gBAAgB,EAChBC,aAAa,EACbC,gBAAgB,QACX,qBAAkB;AAgBzB,SACEC,kBAAkB,EAClBC,kBAAkB,EAClBC,sBAAsB,QACjB,sBAAmB;AAE1B,SAASC,gBAAgB,QAAQ,yBAAsB;AACvD,SAASC,SAAS,QAA+B,0BAAuB;AAExE,SACEC,oBAAoB,EACpBC,0BAA0B,EAC1BC,oCAAoC,EACpCC,iCAAiC,QAC5B,gBAAa;AAEpB,SACEC,yBAAyB,EACzBC,YAAY,QAKP,uBAAoB","ignoreList":[]}

package/lib/module/public/payment-result.js

@@ -0,0 +1,41 @@
+"use strict";
+
+/**
+ * Terminal outcome of a payment flow — narrow on the `status` field.
+ */
+
+/** Payment completed at the bank. `exchangeCode` may be null when recovered
+ * via status polling (the bank delivered the code straight to the merchant
+ * backend, bypassing the SDK). */
+
+/** Payment failed. Always has an `errorCode` so merchants can map to UI copy. */
+
+/** Flow abandoned mid-flight (app killed, host removed the SDK navigator). */
+
+// ---- Constructor helpers ---------------------------------------------------
+
+export function paymentSuccess(args) {
+  return {
+    status: 'success',
+    ...args
+  };
+}
+export function paymentCancelled(args) {
+  return {
+    status: 'cancelled',
+    ...args
+  };
+}
+export function paymentFailed(args) {
+  return {
+    status: 'failed',
+    ...args
+  };
+}
+export function paymentAbandoned(args) {
+  return {
+    status: 'abandoned',
+    ...args
+  };
+}
+//# sourceMappingURL=payment-result.js.map

package/lib/module/public/payment-result.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["paymentSuccess","args","status","paymentCancelled","paymentFailed","paymentAbandoned"],"sourceRoot":"../../../src","sources":["public/payment-result.ts"],"mappings":";;AAAA;AACA;AACA;;AAcA;AACA;AACA;;AAaA;;AAMA;;AAOA;;AAEA,OAAO,SAASA,cAAcA,CAACC,IAAoC,EAAkB;EACnF,OAAO;IAAEC,MAAM,EAAE,SAAS;IAAE,GAAGD;EAAK,CAAC;AACvC;AAEA,OAAO,SAASE,gBAAgBA,CAACF,IAAsC,EAAoB;EACzF,OAAO;IAAEC,MAAM,EAAE,WAAW;IAAE,GAAGD;EAAK,CAAC;AACzC;AAEA,OAAO,SAASG,aAAaA,CAACH,IAAmC,EAAiB;EAChF,OAAO;IAAEC,MAAM,EAAE,QAAQ;IAAE,GAAGD;EAAK,CAAC;AACtC;AAEA,OAAO,SAASI,gBAAgBA,CAACJ,IAAsC,EAAoB;EACzF,OAAO;IAAEC,MAAM,EAAE,WAAW;IAAE,GAAGD;EAAK,CAAC;AACzC","ignoreList":[]}

package/lib/module/public/recovery-result.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * Why {@link SpareLink.resumeIfNeeded} did not recover a terminal session.
+ * Mirrors Flutter's `NoRecoveryReason`.
+ */
+
+/**
+ * Outcome of {@link SpareLink.resumeIfNeeded}.
+ *
+ * Discriminated union aligned with Flutter's sealed `RecoveryResult`.
+ */
+
+/** No pending session was recovered. */
+
+/** A pending session was recovered to a terminal {@link PaymentResult}. */
+
+/**
+ * A pending session is non-terminal and the SDK opened its recovery UI —
+ * the integrator should treat this as in-progress, not "nothing happened".
+ * The terminal outcome arrives later via `SpareLink.events` /
+ * `spareLink.emitTerminal`, not as a second `resumeIfNeeded` resolution.
+ */
+
+export function isSessionRecovered(r) {
+  return r.kind === 'recovered';
+}
+export function isNoRecoveryNeeded(r) {
+  return r.kind === 'none';
+}
+export function isRecoveryAwaitingUser(r) {
+  return r.kind === 'awaitingUser';
+}
+//# sourceMappingURL=recovery-result.js.map

package/lib/module/public/recovery-result.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isSessionRecovered","r","kind","isNoRecoveryNeeded","isRecoveryAwaitingUser"],"sourceRoot":"../../../src","sources":["public/recovery-result.ts"],"mappings":";;AAEA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;;AAGA;;AAMA;;AAMA;AACA;AACA;AACA;AACA;AACA;;AAMA,OAAO,SAASA,kBAAkBA,CAACC,CAAiB,EAAyB;EAC3E,OAAOA,CAAC,CAACC,IAAI,KAAK,WAAW;AAC/B;AAEA,OAAO,SAASC,kBAAkBA,CAACF,CAAiB,EAAyB;EAC3E,OAAOA,CAAC,CAACC,IAAI,KAAK,MAAM;AAC1B;AAEA,OAAO,SAASE,sBAAsBA,CAACH,CAAiB,EAA6B;EACnF,OAAOA,CAAC,CAACC,IAAI,KAAK,cAAc;AAClC","ignoreList":[]}

package/lib/module/public/spare-link-callbacks.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=spare-link-callbacks.js.map

package/lib/module/public/spare-link-callbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["public/spare-link-callbacks.ts"],"mappings":"","ignoreList":[]}

package/lib/module/public/spare-link-config.js

@@ -0,0 +1,54 @@
+"use strict";
+
+/**
+ * Deployment environment for the Spare Link API.
+ *
+ * Each value maps to a default base URL
+ * the SDK will hit unless `baseUrl` is overridden in {@link SpareLinkConfig}.
+ */
+
+const DEFAULT_BASE_URLS = {
+  sandbox: 'https://api.sandbox.tryspare.ae',
+  production: 'https://api.tryspare.ae'
+};
+export function defaultBaseUrlFor(env) {
+  return DEFAULT_BASE_URLS[env];
+}
+
+/** Spare API tenant — one country per tenant. */
+
+const TENANT_COUNTRY_CODES = {
+  ksa: 'KSA',
+  uae: 'UAE',
+  bah: 'BAH'
+};
+export function tenantCountryCode(t) {
+  return TENANT_COUNTRY_CODES[t];
+}
+
+/** Configuration to start a Spare Link payment flow. */
+
+/** Resolved base URL: explicit `baseUrl` if provided, else the environment default. */
+export function resolvedBaseUrl(config) {
+  return config.baseUrl ?? defaultBaseUrlFor(config.environment);
+}
+
+/**
+ * Recovery config — like {@link SpareLinkConfig} but without `linkToken`
+ * (read from the persisted record).
+ */
+
+export function resolvedResumeBaseUrl(config) {
+  return config.baseUrl ?? defaultBaseUrlFor(config.environment);
+}
+
+/** Throws if a SpareLinkConfig is structurally invalid. */
+export function assertValidConfig(config) {
+  if (!config.linkToken) {
+    throw new Error('SpareLinkConfig: linkToken must not be empty');
+  }
+  if (config.baseUrl && !/^https?:\/\//.test(config.baseUrl)) {
+    throw new Error('SpareLinkConfig: baseUrl must start with http:// or https://');
+  }
+}
+//# sourceMappingURL=spare-link-config.js.map

package/lib/module/public/spare-link-config.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DEFAULT_BASE_URLS","sandbox","production","defaultBaseUrlFor","env","TENANT_COUNTRY_CODES","ksa","uae","bah","tenantCountryCode","t","resolvedBaseUrl","config","baseUrl","environment","resolvedResumeBaseUrl","assertValidConfig","linkToken","Error","test"],"sourceRoot":"../../../src","sources":["public/spare-link-config.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;;AAGA,MAAMA,iBAAqD,GAAG;EAC5DC,OAAO,EAAE,iCAAiC;EAC1CC,UAAU,EAAE;AACd,CAAC;AAED,OAAO,SAASC,iBAAiBA,CAACC,GAAuB,EAAU;EACjE,OAAOJ,iBAAiB,CAACI,GAAG,CAAC;AAC/B;;AAEA;;AAGA,MAAMC,oBAAoD,GAAG;EAC3DC,GAAG,EAAE,KAAK;EACVC,GAAG,EAAE,KAAK;EACVC,GAAG,EAAE;AACP,CAAC;AAED,OAAO,SAASC,iBAAiBA,CAACC,CAAiB,EAAU;EAC3D,OAAOL,oBAAoB,CAACK,CAAC,CAAC;AAChC;;AAEA;;AA2BA;AACA,OAAO,SAASC,eAAeA,CAACC,MAAuB,EAAU;EAC/D,OAAOA,MAAM,CAACC,OAAO,IAAIV,iBAAiB,CAACS,MAAM,CAACE,WAAW,CAAC;AAChE;;AAEA;AACA;AACA;AACA;;AASA,OAAO,SAASC,qBAAqBA,CAACH,MAA6B,EAAU;EAC3E,OAAOA,MAAM,CAACC,OAAO,IAAIV,iBAAiB,CAACS,MAAM,CAACE,WAAW,CAAC;AAChE;;AAEA;AACA,OAAO,SAASE,iBAAiBA,CAACJ,MAAuB,EAAQ;EAC/D,IAAI,CAACA,MAAM,CAACK,SAAS,EAAE;IACrB,MAAM,IAAIC,KAAK,CAAC,8CAA8C,CAAC;EACjE;EACA,IAAIN,MAAM,CAACC,OAAO,IAAI,CAAC,cAAc,CAACM,IAAI,CAACP,MAAM,CAACC,OAAO,CAAC,EAAE;IAC1D,MAAM,IAAIK,KAAK,CAAC,8DAA8D,CAAC;EACjF;AACF","ignoreList":[]}

package/lib/module/public/spare-link-event.js

@@ -0,0 +1,115 @@
+"use strict";
+
+/**
+ * Lifecycle events emitted on {@link SpareLink.events}.
+ *
+ * This is a discriminated union (TypeScript's equivalent to Dart sealed classes).
+ * Use a switch on the `type` field for exhaustive handling:
+ *
+ * ```ts
+ * spareLink.events.subscribe((event) => {
+ *   switch (event.type) {
+ *     case 'initialized':
+ *       console.log('Started flow for', event.linkToken);
+ *       break;
+ *     case 'sessionLoaded':
+ *       console.log('Session loaded', event.linkSessionId);
+ *       break;
+ *     case 'succeeded':
+ *       console.log('Payment succeeded', event.result.exchangeCode);
+ *       break;
+ *     // ...
+ *   }
+ * });
+ * ```
+ */
+
+/** The SDK has started a payment flow. */
+
+/** The payment session was loaded from the server. */
+
+/** The user confirmed consent and a consent request was submitted. */
+
+/** The user is being redirected to their bank's authorization page. */
+
+/** The bank has redirected back with a callback URI. */
+
+/** The payment completed successfully and the flow is about to resolve. */
+
+/** The payment failed and the flow is about to resolve. */
+
+/** The user cancelled the payment and the flow is about to resolve. */
+
+/** The flow was abandoned without an explicit user action. */
+
+/** All possible event type strings for type narrowing. */
+export const SPARE_LINK_EVENT_TYPES = ['initialized', 'sessionLoaded', 'consentStarted', 'redirectToBank', 'bankCallbackReceived', 'succeeded', 'failed', 'cancelled', 'abandoned'];
+/** Type guard for SpareLinkEvent. */
+export function isSpareLinkEvent(value) {
+  if (typeof value !== 'object' || value === null) return false;
+  const type = value.type;
+  return typeof type === 'string' && SPARE_LINK_EVENT_TYPES.includes(type);
+}
+
+/** Factory functions for creating events (internal use). */
+export const SpareLinkEvents = {
+  initialized(linkToken) {
+    return {
+      type: 'initialized',
+      linkToken
+    };
+  },
+  sessionLoaded(linkToken, linkSessionId) {
+    return linkSessionId ? {
+      type: 'sessionLoaded',
+      linkToken,
+      linkSessionId
+    } : {
+      type: 'sessionLoaded',
+      linkToken
+    };
+  },
+  consentStarted(linkToken) {
+    return {
+      type: 'consentStarted',
+      linkToken
+    };
+  },
+  redirectToBank(linkToken) {
+    return {
+      type: 'redirectToBank',
+      linkToken
+    };
+  },
+  bankCallbackReceived(linkToken) {
+    return {
+      type: 'bankCallbackReceived',
+      linkToken
+    };
+  },
+  succeeded(result) {
+    return {
+      type: 'succeeded',
+      result
+    };
+  },
+  failed(result) {
+    return {
+      type: 'failed',
+      result
+    };
+  },
+  cancelled(result) {
+    return {
+      type: 'cancelled',
+      result
+    };
+  },
+  abandoned(result) {
+    return {
+      type: 'abandoned',
+      result
+    };
+  }
+};
+//# sourceMappingURL=spare-link-event.js.map

package/lib/module/public/spare-link-event.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SPARE_LINK_EVENT_TYPES","isSpareLinkEvent","value","type","includes","SpareLinkEvents","initialized","linkToken","sessionLoaded","linkSessionId","consentStarted","redirectToBank","bankCallbackReceived","succeeded","result","failed","cancelled","abandoned"],"sourceRoot":"../../../src","sources":["public/spare-link-event.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAYA;;AAMA;;AAQA;;AAMA;;AAMA;;AAMA;;AAMA;;AAMA;;AAMA;;AAMA;AACA,OAAO,MAAMA,sBAAsB,GAAG,CACpC,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,WAAW,CACH;AAIV;AACA,OAAO,SAASC,gBAAgBA,CAACC,KAAc,EAA2B;EACxE,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI,EAAE,OAAO,KAAK;EAC7D,MAAMC,IAAI,GAAID,KAAK,CAAwBC,IAAI;EAC/C,OAAO,OAAOA,IAAI,KAAK,QAAQ,IAAIH,sBAAsB,CAACI,QAAQ,CAACD,IAA0B,CAAC;AAChG;;AAEA;AACA,OAAO,MAAME,eAAe,GAAG;EAC7BC,WAAWA,CAACC,SAAiB,EAAwB;IACnD,OAAO;MAAEJ,IAAI,EAAE,aAAa;MAAEI;IAAU,CAAC;EAC3C,CAAC;EACDC,aAAaA,CAACD,SAAiB,EAAEE,aAAsB,EAA0B;IAC/E,OAAOA,aAAa,GAChB;MAAEN,IAAI,EAAE,eAAe;MAAEI,SAAS;MAAEE;IAAc,CAAC,GACnD;MAAEN,IAAI,EAAE,eAAe;MAAEI;IAAU,CAAC;EAC1C,CAAC;EACDG,cAAcA,CAACH,SAAiB,EAA2B;IACzD,OAAO;MAAEJ,IAAI,EAAE,gBAAgB;MAAEI;IAAU,CAAC;EAC9C,CAAC;EACDI,cAAcA,CAACJ,SAAiB,EAA2B;IACzD,OAAO;MAAEJ,IAAI,EAAE,gBAAgB;MAAEI;IAAU,CAAC;EAC9C,CAAC;EACDK,oBAAoBA,CAACL,SAAiB,EAAiC;IACrE,OAAO;MAAEJ,IAAI,EAAE,sBAAsB;MAAEI;IAAU,CAAC;EACpD,CAAC;EACDM,SAASA,CAACC,MAAqB,EAAsB;IACnD,OAAO;MAAEX,IAAI,EAAE,WAAW;MAAEW;IAAO,CAAC;EACtC,CAAC;EACDC,MAAMA,CAACD,MAAqB,EAAmB;IAC7C,OAAO;MAAEX,IAAI,EAAE,QAAQ;MAAEW;IAAO,CAAC;EACnC,CAAC;EACDE,SAASA,CAACF,MAAqB,EAAsB;IACnD,OAAO;MAAEX,IAAI,EAAE,WAAW;MAAEW;IAAO,CAAC;EACtC,CAAC;EACDG,SAASA,CAACH,MAAqB,EAAsB;IACnD,OAAO;MAAEX,IAAI,EAAE,WAAW;MAAEW;IAAO,CAAC;EACtC;AACF,CAAU","ignoreList":[]}

package/lib/module/public/spare-link-host-api.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=spare-link-host-api.js.map

package/lib/module/public/spare-link-host-api.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["public/spare-link-host-api.ts"],"mappings":"","ignoreList":[]}

package/lib/module/public/spare-link-instance.js

@@ -0,0 +1,273 @@
+"use strict";
+
+import { createEventEmitter } from "../internal/event-emitter.js";
+import { paymentAbandoned } from "./payment-result.js";
+import { isSessionRecovered } from "./recovery-result.js";
+import { defaultBaseUrlFor } from "./spare-link-config.js";
+import { SpareLinkEvents } from "./spare-link-event.js";
+import { SpareLinkSession } from "./spare-link-session.js";
+/**
+ * Entry point for the Spare Link payment SDK — aligned with Flutter's
+ * instance-based {@link SpareLink} API.
+ *
+ * Mount {@link SpareLinkHost} once near your app root and pass this instance:
+ *
+ * ```tsx
+ * const spareLink = useMemo(
+ *   () => new SpareLink({ environment: 'sandbox', tenant: 'uae' }),
+ *   [],
+ * );
+ *
+ * <SpareLinkHost spareLink={spareLink}>
+ *   <App />
+ * </SpareLinkHost>
+ * ```
+ */
+export class SpareLink {
+  _events = createEventEmitter();
+  _host = null;
+  _disposed = false;
+  _pendingStarts = [];
+  _pendingRedirects = [];
+  _pendingResumes = [];
+  constructor(options) {
+    this.environment = options.environment;
+    this.tenant = options.tenant;
+    this.baseUrl = options.baseUrl;
+    this.fetch = options.fetch;
+    this.requestTimeoutMs = options.requestTimeoutMs;
+    this.pendingSessionStore = options.pendingSessionStore;
+  }
+
+  /** Lifecycle events for all flows started on this instance. */
+  get events() {
+    return this._events;
+  }
+  get resolvedBaseUrl() {
+    return this.baseUrl ?? defaultBaseUrlFor(this.environment);
+  }
+
+  /** Returns `true` while a payment flow started via {@link start} is in progress. */
+  get isFlowActive() {
+    return this._host?.isFlowActive() ?? false;
+  }
+
+  /**
+   * Starts a new payment flow.
+   *
+   * Returns a {@link SpareLinkSession} immediately; await `session.result`
+   * for the terminal outcome.
+   */
+  async start(args) {
+    const {
+      linkToken
+    } = args;
+    if (!linkToken) {
+      const result = paymentAbandoned({
+        linkToken: '',
+        message: 'SpareLinkConfig: linkToken must not be empty',
+        resolvedAtMs: Date.now()
+      });
+      this._emitTerminal(result);
+      return new SpareLinkSession({
+        linkToken: '',
+        result: Promise.resolve(result)
+      });
+    }
+    if (this._disposed) {
+      const result = paymentAbandoned({
+        linkToken,
+        message: 'SpareLink has been disposed.',
+        resolvedAtMs: Date.now()
+      });
+      this._emitTerminal(result);
+      return new SpareLinkSession({
+        linkToken,
+        result: Promise.resolve(result)
+      });
+    }
+    this._events.emit(SpareLinkEvents.initialized(linkToken));
+    if (!this._host) {
+      return new Promise(resolve => {
+        this._pendingStarts.push({
+          linkToken,
+          resolve
+        });
+      });
+    }
+    return this._hostStart(linkToken);
+  }
+
+  /** Processes a deep-link URI received from the bank. */
+  async handleRedirect(uri) {
+    if (this._disposed) return false;
+    if (!this._host) {
+      return new Promise(resolve => {
+        this._pendingRedirects.push({
+          uri,
+          resolve
+        });
+      });
+    }
+    return this._host.handleRedirect(uri);
+  }
+
+  /** Checks for a pending session saved during a previous flow and recovers it. */
+  async resumeIfNeeded() {
+    if (this._disposed) {
+      return {
+        kind: 'none',
+        reason: 'persistenceUnavailable'
+      };
+    }
+    if (!this.pendingSessionStore) {
+      return {
+        kind: 'none',
+        reason: 'persistenceUnavailable'
+      };
+    }
+    if (!this._host) {
+      return new Promise(resolve => {
+        this._pendingResumes.push({
+          resolve
+        });
+      });
+    }
+    return this._host.resumeIfNeeded();
+  }
+  dispose() {
+    this._disposed = true;
+    const starts = this._pendingStarts.splice(0);
+    const redirects = this._pendingRedirects.splice(0);
+    const resumes = this._pendingResumes.splice(0);
+    for (const p of starts) {
+      const result = paymentAbandoned({
+        linkToken: p.linkToken,
+        message: 'SpareLink has been disposed.',
+        resolvedAtMs: Date.now()
+      });
+      this._emitTerminal(result);
+      p.resolve(new SpareLinkSession({
+        linkToken: p.linkToken,
+        result: Promise.resolve(result)
+      }));
+    }
+    for (const p of redirects) {
+      p.resolve(false);
+    }
+    for (const p of resumes) {
+      p.resolve({
+        kind: 'none',
+        reason: 'persistenceUnavailable'
+      });
+    }
+    this._events.dispose();
+    this._host = null;
+  }
+
+  /**
+   * Called by {@link SpareLinkHost} on mount. Drains any buffered calls.
+   *
+   * @internal
+   */
+  _attachHost(host) {
+    this._host = host;
+    this._drainPending(host);
+    return () => {
+      if (this._host === host) this._host = null;
+    };
+  }
+
+  /** @internal */
+  emitEvent(event) {
+    this._events.emit(event);
+  }
+
+  /** @internal */
+  emitTerminal(result) {
+    this._emitTerminal(result);
+  }
+  _emitTerminal(result) {
+    switch (result.status) {
+      case 'success':
+        this._events.emit(SpareLinkEvents.succeeded(result));
+        break;
+      case 'failed':
+        this._events.emit(SpareLinkEvents.failed(result));
+        break;
+      case 'cancelled':
+        this._events.emit(SpareLinkEvents.cancelled(result));
+        break;
+      case 'abandoned':
+        this._events.emit(SpareLinkEvents.abandoned(result));
+        break;
+    }
+  }
+  async _hostStart(linkToken) {
+    const host = this._host;
+    if (!host) {
+      return new Promise(resolve => {
+        this._pendingStarts.push({
+          linkToken,
+          resolve
+        });
+      });
+    }
+    let resolveResult;
+    const resultPromise = new Promise(resolve => {
+      resolveResult = resolve;
+    });
+    const session = new SpareLinkSession({
+      linkToken,
+      result: resultPromise
+    });
+    host.startFlow({
+      linkToken,
+      resolve: result => {
+        this._emitTerminal(result);
+        resolveResult(result);
+      },
+      onSessionLoaded: linkSessionId => {
+        session.updateLinkSessionId(linkSessionId);
+        this._events.emit(SpareLinkEvents.sessionLoaded(linkToken, linkSessionId));
+      }
+    });
+    return session;
+  }
+  _drainPending(host) {
+    const starts = this._pendingStarts.splice(0);
+    const redirects = this._pendingRedirects.splice(0);
+    const resumes = this._pendingResumes.splice(0);
+    for (const p of starts) {
+      void this._hostStart(p.linkToken).then(p.resolve);
+    }
+    for (const p of redirects) {
+      void host.handleRedirect(p.uri).then(p.resolve, () => p.resolve(false));
+    }
+    for (const p of resumes) {
+      void host.resumeIfNeeded().then(p.resolve, () => p.resolve({
+        kind: 'none',
+        reason: 'persistenceUnavailable'
+      }));
+    }
+  }
+}
+
+/** Map legacy recovery helper outcomes to Flutter-aligned {@link RecoveryResult}. */
+export function mapHostRecovery(recovery) {
+  if (recovery.kind === 'inProgress') {
+    return {
+      kind: 'awaitingUser',
+      linkToken: recovery.linkToken
+    };
+  }
+  return recovery;
+}
+export function noRecovery(reason) {
+  return {
+    kind: 'none',
+    reason
+  };
+}
+export { isSessionRecovered };
+//# sourceMappingURL=spare-link-instance.js.map

package/lib/module/public/spare-link-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createEventEmitter","paymentAbandoned","isSessionRecovered","defaultBaseUrlFor","SpareLinkEvents","SpareLinkSession","SpareLink","_events","_host","_disposed","_pendingStarts","_pendingRedirects","_pendingResumes","constructor","options","environment","tenant","baseUrl","fetch","requestTimeoutMs","pendingSessionStore","events","resolvedBaseUrl","isFlowActive","start","args","linkToken","result","message","resolvedAtMs","Date","now","_emitTerminal","Promise","resolve","emit","initialized","push","_hostStart","handleRedirect","uri","resumeIfNeeded","kind","reason","dispose","starts","splice","redirects","resumes","p","_attachHost","host","_drainPending","emitEvent","event","emitTerminal","status","succeeded","failed","cancelled","abandoned","resolveResult","resultPromise","session","startFlow","onSessionLoaded","linkSessionId","updateLinkSessionId","sessionLoaded","then","mapHostRecovery","recovery","noRecovery"],"sourceRoot":"../../../src","sources":["public/spare-link-instance.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/public/spare-link-session.js

@@ -0,0 +1,21 @@
+"use strict";
+
+/**
+ * Handle for an in-flight or completed payment started via {@link SpareLink.start}.
+ *
+ * Mirrors Flutter's `SpareLinkSession` — `linkToken` is available immediately;
+ * await `result` for the terminal outcome.
+ */
+export class SpareLinkSession {
+  constructor(args) {
+    this.linkToken = args.linkToken;
+    this.linkSessionId = args.linkSessionId;
+    this.result = args.result;
+  }
+
+  /** Called internally when the server provides {@link linkSessionId}. */
+  updateLinkSessionId(value) {
+    this.linkSessionId = value;
+  }
+}
+//# sourceMappingURL=spare-link-session.js.map

package/lib/module/public/spare-link-session.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SpareLinkSession","constructor","args","linkToken","linkSessionId","result","updateLinkSessionId","value"],"sourceRoot":"../../../src","sources":["public/spare-link-session.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,gBAAgB,CAAC;EAK5BC,WAAWA,CAACC,IAIX,EAAE;IACD,IAAI,CAACC,SAAS,GAAGD,IAAI,CAACC,SAAS;IAC/B,IAAI,CAACC,aAAa,GAAGF,IAAI,CAACE,aAAa;IACvC,IAAI,CAACC,MAAM,GAAGH,IAAI,CAACG,MAAM;EAC3B;;EAEA;EACAC,mBAAmBA,CAACC,KAAa,EAAQ;IACvC,IAAI,CAACH,aAAa,GAAGG,KAAK;EAC5B;AACF","ignoreList":[]}

package/lib/module/public/spare-link.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export { SpareLink, mapHostRecovery, noRecovery, isSessionRecovered } from "./spare-link-instance.js";
+//# sourceMappingURL=spare-link.js.map

package/lib/module/public/spare-link.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SpareLink","mapHostRecovery","noRecovery","isSessionRecovered"],"sourceRoot":"../../../src","sources":["public/spare-link.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,eAAe,EAAEC,UAAU,EAAEC,kBAAkB,QAAQ,0BAAuB","ignoreList":[]}