@spare-technologies/spare-link 0.1.0-beta.1 → 1.0.0

package/lib/module/internal/url-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SCHEME_AND_AUTHORITY","DEFAULT_PORTS","http","https","parseUrlParts","url","match","exec","trim","undefined","scheme","toLowerCase","authority","slice","lastIndexOf","hostAndPort","splitHostAndPort","host","portText","length","port","test","Number","parseInt","isSameOrigin","a","b","left","right","parseQueryParams","params","start","indexOf","fragment","query","pair","split","eq","rawKey","rawValue","key","decodeFormComponent","Object","hasOwn","startsWith","close","rest","colon","value","plusesAsSpaces","replace","decodeURIComponent"],"sourceRoot":"../../../src","sources":["internal/url-parts.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/public/index.js

@@ -1,11 +1,10 @@
 "use strict";
 
-export { defaultBaseUrlFor, tenantCountryCode, resolvedBaseUrl, resolvedResumeBaseUrl, assertValidConfig } from "./spare-link-config.js";
+export { defaultBaseUrlFor, tenantCountryCode, resolvedBaseUrl, 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 { isSessionRecovered, isNoRecoveryNeeded } 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

@@ -1 +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":[]}
+{"version":3,"names":["defaultBaseUrlFor","tenantCountryCode","resolvedBaseUrl","assertValidConfig","SPARE_LINK_EVENT_TYPES","isSpareLinkEvent","SpareLinkEvents","paymentSuccess","paymentCancelled","paymentFailed","paymentAbandoned","isSessionRecovered","isNoRecoveryNeeded","SpareLinkSession","SpareLink","configureSpareLinkLogging","createLogger"],"sourceRoot":"../../../src","sources":["public/index.ts"],"mappings":";;AAAA,SAIEA,iBAAiB,EACjBC,iBAAiB,EACjBC,eAAe,EACfC,iBAAiB,QACZ,wBAAqB;AAE5B,SAWEC,sBAAsB,EACtBC,gBAAgB,EAChBC,eAAe,QACV,uBAAoB;AAE3B,SAOEC,cAAc,EACdC,gBAAgB,EAChBC,aAAa,EACbC,gBAAgB,QACX,qBAAkB;AAQzB,SAASC,kBAAkB,EAAEC,kBAAkB,QAAQ,sBAAmB;AAE1E,SAASC,gBAAgB,QAAQ,yBAAsB;AACvD,SAASC,SAAS,QAA+B,0BAAuB;AAExE,SACEC,yBAAyB,EACzBC,YAAY,QAKP,uBAAoB","ignoreList":[]}

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

@@ -2,15 +2,27 @@
 
 /**
  * Terminal outcome of a payment flow — narrow on the `status` field.
+ *
+ * Every result here is read off a deep link, which is interceptable by design
+ * and names no bank identifiers. It reports what happened rather than attesting
+ * to it: confirm with your backend via `GET /payment-requests/{reference}`
+ * before acting on one.
  */
 
-/** 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). */
+/**
+ * The return reported a completed payment.
+ *
+ * Treat this as a prompt to confirm with your backend, not as settlement.
+ */
 
 /** Payment failed. Always has an `errorCode` so merchants can map to UI copy. */
 
-/** Flow abandoned mid-flight (app killed, host removed the SDK navigator). */
+/**
+ * The payer left before the flow resolved either way.
+ *
+ * A payment already at the bank may still complete after this, so it is not a
+ * failure — only your backend knows how it ended.
+ */
 
 // ---- Constructor helpers ---------------------------------------------------
 

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

@@ -1 +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":[]}
+{"version":3,"names":["paymentSuccess","args","status","paymentCancelled","paymentFailed","paymentAbandoned"],"sourceRoot":"../../../src","sources":["public/payment-result.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AA4CA;AACA;AACA;AACA;AACA;;AASA;;AAMA;AACA;AACA;AACA;AACA;AACA;;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

@@ -2,25 +2,18 @@
 
 /**
  * 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`.
+ * `outcomeUnknown` is the one that carries weight: a payment was pending and no
+ * return arrived, so **it may have completed**. The SDK holds no credentials and
+ * has nothing to ask with — the reference is handed back for your backend to
+ * resolve.
  */
 
-/** No pending session was recovered. */
+/** Outcome of {@link SpareLink.resumeIfNeeded}. */
 
-/** A pending session was recovered to a terminal {@link PaymentResult}. */
+/** No pending payment was resolved to a terminal outcome. */
 
-/**
- * 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.
- */
+/** A pending payment was resolved to a terminal {@link PaymentResult}. */
 
 export function isSessionRecovered(r) {
   return r.kind === 'recovered';
@@ -28,7 +21,4 @@ export function isSessionRecovered(r) {
 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

@@ -1 +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":[]}
+{"version":3,"names":["isSessionRecovered","r","kind","isNoRecoveryNeeded"],"sourceRoot":"../../../src","sources":["public/recovery-result.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;;AAGA;;AAQA;;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","ignoreList":[]}

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

@@ -1,18 +1,40 @@
 "use strict";
 
+import { Platform } from 'react-native';
+
+/**
+ * Deployment environment for the Spare Link API, which is also where the hosted
+ * payment page is served from.
+ */
+
+/** Default port an Encore app serves on. */
+const LOCAL_PORT = 4000;
+
 /**
- * Deployment environment for the Spare Link API.
+ * A Spare API running on the developer's own machine.
  *
- * Each value maps to a default base URL
- * the SDK will hit unless `baseUrl` is overridden in {@link SpareLinkConfig}.
+ * The host differs by platform because an emulator's `localhost` is the emulator,
+ * not the machine hosting it. A **physical device** reaches neither, so pass
+ * `baseUrl` with your machine's address on the local network instead.
+ *
+ * Serves over plain HTTP, which both platforms block by default. See the
+ * integration notes for the debug-only exceptions that allow it.
  */
+function localBaseUrl() {
+  return Platform.OS === 'android' ? `http://10.0.2.2:${LOCAL_PORT}` : `http://localhost:${LOCAL_PORT}`;
+}
 
+/**
+ * `dev` is Spare's own integration environment, not one an integrator would ship
+ * against. Unlike the others its host names a single tenant, so it serves UAE alone.
+ */
 const DEFAULT_BASE_URLS = {
+  dev: 'https://api-dev-uae.tryspare.ae',
   sandbox: 'https://api.sandbox.tryspare.ae',
   production: 'https://api.tryspare.ae'
 };
 export function defaultBaseUrlFor(env) {
-  return DEFAULT_BASE_URLS[env];
+  return env === 'local' ? localBaseUrl() : DEFAULT_BASE_URLS[env];
 }
 
 /** Spare API tenant — one country per tenant. */
@@ -26,7 +48,7 @@ export function tenantCountryCode(t) {
   return TENANT_COUNTRY_CODES[t];
 }
 
-/** Configuration to start a Spare Link payment flow. */
+/** Configuration for a Spare Link instance. */
 
 /** Resolved base URL: explicit `baseUrl` if provided, else the environment default. */
 export function resolvedBaseUrl(config) {
@@ -34,21 +56,26 @@ export function resolvedBaseUrl(config) {
 }
 
 /**
- * Recovery config — like {@link SpareLinkConfig} but without `linkToken`
- * (read from the persisted record).
+ * The tenants the hosted flow can actually serve.
+ *
+ * `tenant` accepts the others because the API surface outlives this list, but
+ * accepting one the page cannot serve would put a payer in front of the wrong
+ * country's flow rather than telling the integrator at construction time.
  */
+const SUPPORTED_TENANTS = ['uae'];
 
-export function resolvedResumeBaseUrl(config) {
-  return config.baseUrl ?? defaultBaseUrlFor(config.environment);
-}
-
-/** Throws if a SpareLinkConfig is structurally invalid. */
+/**
+ * Throws if a config cannot be honoured.
+ *
+ * Called from {@link SpareLink}'s constructor, so a bad value fails where it was
+ * written rather than reaching the webview as a URL nobody meant.
+ */
 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://');
   }
+  if (!SUPPORTED_TENANTS.includes(config.tenant)) {
+    throw new Error(`SpareLinkConfig: the hosted flow does not serve tenant '${config.tenant}' yet ` + `(supported: ${SUPPORTED_TENANTS.join(', ')})`);
+  }
 }
 //# sourceMappingURL=spare-link-config.js.map

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

@@ -1 +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":[]}
+{"version":3,"names":["Platform","LOCAL_PORT","localBaseUrl","OS","DEFAULT_BASE_URLS","dev","sandbox","production","defaultBaseUrlFor","env","TENANT_COUNTRY_CODES","ksa","uae","bah","tenantCountryCode","t","resolvedBaseUrl","config","baseUrl","environment","SUPPORTED_TENANTS","assertValidConfig","test","Error","includes","tenant","join"],"sourceRoot":"../../../src","sources":["public/spare-link-config.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;;AAEvC;AACA;AACA;AACA;;AAGA;AACA,MAAMC,UAAU,GAAG,IAAI;;AAEvB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,YAAYA,CAAA,EAAW;EAC9B,OAAOF,QAAQ,CAACG,EAAE,KAAK,SAAS,GAC5B,mBAAmBF,UAAU,EAAE,GAC/B,oBAAoBA,UAAU,EAAE;AACtC;;AAEA;AACA;AACA;AACA;AACA,MAAMG,iBAAiF,GAAG;EACxFC,GAAG,EAAE,iCAAiC;EACtCC,OAAO,EAAE,iCAAiC;EAC1CC,UAAU,EAAE;AACd,CAAC;AAED,OAAO,SAASC,iBAAiBA,CAACC,GAAuB,EAAU;EACjE,OAAOA,GAAG,KAAK,OAAO,GAAGP,YAAY,CAAC,CAAC,GAAGE,iBAAiB,CAACK,GAAG,CAAC;AAClE;;AAEA;;AAGA,MAAMC,oBAA8D,GAAG;EACrEC,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;;AAeA;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;AACA;AACA;AACA;AACA,MAAMC,iBAA4C,GAAG,CAAC,KAAK,CAAC;;AAE5D;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACJ,MAAuB,EAAQ;EAC/D,IAAIA,MAAM,CAACC,OAAO,IAAI,CAAC,cAAc,CAACI,IAAI,CAACL,MAAM,CAACC,OAAO,CAAC,EAAE;IAC1D,MAAM,IAAIK,KAAK,CAAC,8DAA8D,CAAC;EACjF;EACA,IAAI,CAACH,iBAAiB,CAACI,QAAQ,CAACP,MAAM,CAACQ,MAAM,CAAC,EAAE;IAC9C,MAAM,IAAIF,KAAK,CACb,2DAA2DN,MAAM,CAACQ,MAAM,QAAQ,GAC9E,eAAeL,iBAAiB,CAACM,IAAI,CAAC,IAAI,CAAC,GAC/C,CAAC;EACH;AACF","ignoreList":[]}

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

@@ -3,20 +3,21 @@
 /**
  * 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:
+ * Analytics only — never required to drive the flow. This is a discriminated
+ * union (TypeScript's equivalent to Dart sealed classes); switch on `type` for
+ * exhaustive handling:
  *
  * ```ts
  * spareLink.events.subscribe((event) => {
  *   switch (event.type) {
  *     case 'initialized':
- *       console.log('Started flow for', event.linkToken);
+ *       console.log('Started flow for', event.reference);
  *       break;
- *     case 'sessionLoaded':
- *       console.log('Session loaded', event.linkSessionId);
+ *     case 'pageReady':
+ *       console.log('Payer can act on the page');
  *       break;
  *     case 'succeeded':
- *       console.log('Payment succeeded', event.result.exchangeCode);
+ *       console.log('Reported success for', event.result.reference);
  *       break;
  *     // ...
  *   }
@@ -26,24 +27,27 @@
 
 /** 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 hosted page is interactive and the payer has something to act on.
+ *
+ * The steps after this — choosing a bank, the payee check, reading the consent —
+ * happen inside the page, which does not report them.
+ */
 
-/** The user is being redirected to their bank's authorization page. */
+/** The payer is being handed to their bank, outside the WebView. */
 
 /** The bank has redirected back with a callback URI. */
 
-/** The payment completed successfully and the flow is about to resolve. */
+/** The return reported a completed payment 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 payer cancelled the payment and the flow is about to resolve. */
 
-/** The flow was abandoned without an explicit user action. */
+/** The payer left before the flow resolved either way. */
 
 /** All possible event type strings for type narrowing. */
-export const SPARE_LINK_EVENT_TYPES = ['initialized', 'sessionLoaded', 'consentStarted', 'redirectToBank', 'bankCallbackReceived', 'succeeded', 'failed', 'cancelled', 'abandoned'];
+export const SPARE_LINK_EVENT_TYPES = ['initialized', 'pageReady', 'redirectToBank', 'bankCallbackReceived', 'succeeded', 'failed', 'cancelled', 'abandoned'];
 /** Type guard for SpareLinkEvent. */
 export function isSpareLinkEvent(value) {
   if (typeof value !== 'object' || value === null) return false;
@@ -53,38 +57,28 @@ export function isSpareLinkEvent(value) {
 
 /** Factory functions for creating events (internal use). */
 export const SpareLinkEvents = {
-  initialized(linkToken) {
+  initialized(reference) {
     return {
       type: 'initialized',
-      linkToken
-    };
-  },
-  sessionLoaded(linkToken, linkSessionId) {
-    return linkSessionId ? {
-      type: 'sessionLoaded',
-      linkToken,
-      linkSessionId
-    } : {
-      type: 'sessionLoaded',
-      linkToken
+      reference
     };
   },
-  consentStarted(linkToken) {
+  pageReady(reference) {
     return {
-      type: 'consentStarted',
-      linkToken
+      type: 'pageReady',
+      reference
     };
   },
-  redirectToBank(linkToken) {
+  redirectToBank(reference) {
     return {
       type: 'redirectToBank',
-      linkToken
+      reference
     };
   },
-  bankCallbackReceived(linkToken) {
+  bankCallbackReceived(reference) {
     return {
       type: 'bankCallbackReceived',
-      linkToken
+      reference
     };
   },
   succeeded(result) {

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

@@ -1 +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":[]}
+{"version":3,"names":["SPARE_LINK_EVENT_TYPES","isSpareLinkEvent","value","type","includes","SpareLinkEvents","initialized","reference","pageReady","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;AACA;;AAWA;;AAMA;AACA;AACA;AACA;AACA;AACA;;AAMA;;AAMA;;AAMA;;AAMA;;AAMA;;AAMA;;AAMA;AACA,OAAO,MAAMA,sBAAsB,GAAG,CACpC,aAAa,EACb,WAAW,EACX,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,SAASA,CAACD,SAAiB,EAAsB;IAC/C,OAAO;MAAEJ,IAAI,EAAE,WAAW;MAAEI;IAAU,CAAC;EACzC,CAAC;EACDE,cAAcA,CAACF,SAAiB,EAA2B;IACzD,OAAO;MAAEJ,IAAI,EAAE,gBAAgB;MAAEI;IAAU,CAAC;EAC9C,CAAC;EACDG,oBAAoBA,CAACH,SAAiB,EAAiC;IACrE,OAAO;MAAEJ,IAAI,EAAE,sBAAsB;MAAEI;IAAU,CAAC;EACpD,CAAC;EACDI,SAASA,CAACC,MAAqB,EAAsB;IACnD,OAAO;MAAET,IAAI,EAAE,WAAW;MAAES;IAAO,CAAC;EACtC,CAAC;EACDC,MAAMA,CAACD,MAAqB,EAAmB;IAC7C,OAAO;MAAET,IAAI,EAAE,QAAQ;MAAES;IAAO,CAAC;EACnC,CAAC;EACDE,SAASA,CAACF,MAAqB,EAAsB;IACnD,OAAO;MAAET,IAAI,EAAE,WAAW;MAAES;IAAO,CAAC;EACtC,CAAC;EACDG,SAASA,CAACH,MAAqB,EAAsB;IACnD,OAAO;MAAET,IAAI,EAAE,WAAW;MAAES;IAAO,CAAC;EACtC;AACF,CAAU","ignoreList":[]}

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

@@ -2,13 +2,15 @@
 
 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 { assertValidConfig, 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.
+ * Entry point for the Spare Link payment SDK.
+ *
+ * Your backend creates the payment request — with `channel: 'sdk_react_native'`
+ * and the return URLs your app is registered for — and gives the app the
+ * reference it returns. That reference is all this SDK needs.
  *
  * Mount {@link SpareLinkHost} once near your app root and pass this instance:
  *
@@ -22,6 +24,10 @@ import { SpareLinkSession } from "./spare-link-session.js";
  *   <App />
  * </SpareLinkHost>
  * ```
+ *
+ * The SDK makes no API calls of its own and holds no credentials. Every result
+ * it reports comes from a deep link that is interceptable by design, so confirm
+ * with your backend via `GET /payment-requests/{reference}` before acting on one.
  */
 export class SpareLink {
   _events = createEventEmitter();
@@ -31,11 +37,18 @@ export class SpareLink {
   _pendingRedirects = [];
   _pendingResumes = [];
   constructor(options) {
+    // Fails where the config was written rather than letting a host the page was
+    // never served from reach the webview as a URL nobody meant.
+    assertValidConfig({
+      environment: options.environment,
+      tenant: options.tenant,
+      ...(options.baseUrl ? {
+        baseUrl: options.baseUrl
+      } : {})
+    });
     this.environment = options.environment;
     this.tenant = options.tenant;
     this.baseUrl = options.baseUrl;
-    this.fetch = options.fetch;
-    this.requestTimeoutMs = options.requestTimeoutMs;
     this.pendingSessionStore = options.pendingSessionStore;
   }
 
@@ -53,52 +66,35 @@ export class SpareLink {
   }
 
   /**
-   * Starts a new payment flow.
+   * Opens the hosted payment page for `reference` and resolves when the flow ends.
    *
-   * Returns a {@link SpareLinkSession} immediately; await `session.result`
-   * for the terminal outcome.
+   * Returns a {@link SpareLinkSession} immediately; await `session.result` for the
+   * terminal outcome. There is no session to load first: the page resolves the
+   * request itself, so the payer sees it without waiting on a round trip.
    */
   async start(args) {
     const {
-      linkToken
+      reference
     } = 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 (!reference) {
+      return this._resolveImmediately('', 'SpareLink.start: reference must not be empty');
     }
     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)
-      });
+      return this._resolveImmediately(reference, 'SpareLink has been disposed.');
     }
-    this._events.emit(SpareLinkEvents.initialized(linkToken));
+    this._events.emit(SpareLinkEvents.initialized(reference));
     if (!this._host) {
       return new Promise(resolve => {
         this._pendingStarts.push({
-          linkToken,
+          reference,
           resolve
         });
       });
     }
-    return this._hostStart(linkToken);
+    return this._hostStart(reference);
   }
 
-  /** Processes a deep-link URI received from the bank. */
+  /** Processes a deep-link URI the payer returned through. */
   async handleRedirect(uri) {
     if (this._disposed) return false;
     if (!this._host) {
@@ -112,15 +108,16 @@ export class SpareLink {
     return this._host.handleRedirect(uri);
   }
 
-  /** Checks for a pending session saved during a previous flow and recovers it. */
+  /**
+   * Reports a payment that was left in progress by a previous app session.
+   *
+   * If the return deep link arrived before the app had a flow to give it to, the
+   * outcome is resolved from it. Otherwise the SDK cannot say how the payment
+   * ended — it holds no credentials, so it has nothing to ask with — and reports
+   * `outcomeUnknown` with the reference for your backend to resolve.
+   */
   async resumeIfNeeded() {
-    if (this._disposed) {
-      return {
-        kind: 'none',
-        reason: 'persistenceUnavailable'
-      };
-    }
-    if (!this.pendingSessionStore) {
+    if (this._disposed || !this.pendingSessionStore) {
       return {
         kind: 'none',
         reason: 'persistenceUnavailable'
@@ -142,13 +139,13 @@ export class SpareLink {
     const resumes = this._pendingResumes.splice(0);
     for (const p of starts) {
       const result = paymentAbandoned({
-        linkToken: p.linkToken,
+        reference: p.reference,
         message: 'SpareLink has been disposed.',
         resolvedAtMs: Date.now()
       });
       this._emitTerminal(result);
       p.resolve(new SpareLinkSession({
-        linkToken: p.linkToken,
+        reference: p.reference,
         result: Promise.resolve(result)
       }));
     }
@@ -187,6 +184,18 @@ export class SpareLink {
   emitTerminal(result) {
     this._emitTerminal(result);
   }
+  _resolveImmediately(reference, message) {
+    const result = paymentAbandoned({
+      reference,
+      message,
+      resolvedAtMs: Date.now()
+    });
+    this._emitTerminal(result);
+    return new SpareLinkSession({
+      reference,
+      result: Promise.resolve(result)
+    });
+  }
   _emitTerminal(result) {
     switch (result.status) {
       case 'success':
@@ -203,12 +212,12 @@ export class SpareLink {
         break;
     }
   }
-  async _hostStart(linkToken) {
+  async _hostStart(reference) {
     const host = this._host;
     if (!host) {
       return new Promise(resolve => {
         this._pendingStarts.push({
-          linkToken,
+          reference,
           resolve
         });
       });
@@ -217,29 +226,24 @@ export class SpareLink {
     const resultPromise = new Promise(resolve => {
       resolveResult = resolve;
     });
-    const session = new SpareLinkSession({
-      linkToken,
-      result: resultPromise
-    });
     host.startFlow({
-      linkToken,
+      reference,
       resolve: result => {
         this._emitTerminal(result);
         resolveResult(result);
-      },
-      onSessionLoaded: linkSessionId => {
-        session.updateLinkSessionId(linkSessionId);
-        this._events.emit(SpareLinkEvents.sessionLoaded(linkToken, linkSessionId));
       }
     });
-    return session;
+    return new SpareLinkSession({
+      reference,
+      result: resultPromise
+    });
   }
   _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);
+      void this._hostStart(p.reference).then(p.resolve);
     }
     for (const p of redirects) {
       void host.handleRedirect(p.uri).then(p.resolve, () => p.resolve(false));
@@ -252,22 +256,14 @@ export class SpareLink {
     }
   }
 }
-
-/** 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 {
+export function noRecovery(reason, reference) {
+  return reference ? {
+    kind: 'none',
+    reason,
+    reference
+  } : {
     kind: 'none',
     reason
   };
 }
-export { isSessionRecovered };
 //# sourceMappingURL=spare-link-instance.js.map