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

package/lib/module/core/services/payment-flow-state.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["EMPTY_PROVIDERS","PaymentFlowStates","idle","phase","providers","hydrating","bankSelection","args","session","consentDetails","selectedProvider","copResponse","isCopLoading","undefined","copApplicable","redirecting","consent","awaitingCallback","providerName","succeeded","exchangeCode","linkSessionId","merchantRef","failed","errorCode","errorMessage","cancelled"],"sourceRoot":"../../../../src","sources":["core/services/payment-flow-state.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/services/payment-result-mapper.js

@@ -0,0 +1,45 @@
+"use strict";
+
+import { paymentAbandoned, paymentCancelled, paymentFailed, paymentSuccess } from "../../public/payment-result.js";
+/** Map a terminal controller state to a {@link PaymentResult}. */
+export function paymentResultFromFlowState(state, linkToken, bankId) {
+  const resolvedBankId = bankId ?? state.selectedProvider?.id;
+  switch (state.phase) {
+    case 'succeeded':
+      return paymentSuccess({
+        linkToken,
+        ...(state.exchangeCode ? {
+          exchangeCode: state.exchangeCode
+        } : {}),
+        ...(state.linkSessionId ? {
+          linkSessionId: state.linkSessionId
+        } : {}),
+        ...(state.merchantRef ? {
+          merchantRef: state.merchantRef
+        } : {}),
+        ...(resolvedBankId ? {
+          bankId: resolvedBankId
+        } : {}),
+        resolvedAtMs: Date.now()
+      });
+    case 'failed':
+      return paymentFailed({
+        linkToken,
+        errorCode: state.errorCode ?? 'unknown_error',
+        resolvedAtMs: Date.now()
+      });
+    case 'cancelled':
+      return paymentCancelled({
+        linkToken,
+        ...(resolvedBankId ? {
+          bankId: resolvedBankId
+        } : {}),
+        resolvedAtMs: Date.now()
+      });
+  }
+  return paymentAbandoned({
+    linkToken,
+    resolvedAtMs: Date.now()
+  });
+}
+//# sourceMappingURL=payment-result-mapper.js.map

package/lib/module/core/services/payment-result-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["paymentAbandoned","paymentCancelled","paymentFailed","paymentSuccess","paymentResultFromFlowState","state","linkToken","bankId","resolvedBankId","selectedProvider","id","phase","exchangeCode","linkSessionId","merchantRef","resolvedAtMs","Date","now","errorCode"],"sourceRoot":"../../../../src","sources":["core/services/payment-result-mapper.ts"],"mappings":";;AACA,SACEA,gBAAgB,EAChBC,gBAAgB,EAChBC,aAAa,EACbC,cAAc,QACT,gCAA6B;AAGpC;AACA,OAAO,SAASC,0BAA0BA,CACxCC,KAAuB,EACvBC,SAAiB,EACjBC,MAAe,EACO;EACtB,MAAMC,cAAc,GAAGD,MAAM,IAAIF,KAAK,CAACI,gBAAgB,EAAEC,EAAE;EAC3D,QAAQL,KAAK,CAACM,KAAK;IACjB,KAAK,WAAW;MACd,OAAOR,cAAc,CAAC;QACpBG,SAAS;QACT,IAAID,KAAK,CAACO,YAAY,GAAG;UAAEA,YAAY,EAAEP,KAAK,CAACO;QAAa,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,IAAIP,KAAK,CAACQ,aAAa,GAAG;UAAEA,aAAa,EAAER,KAAK,CAACQ;QAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QACtE,IAAIR,KAAK,CAACS,WAAW,GAAG;UAAEA,WAAW,EAAET,KAAK,CAACS;QAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,IAAIN,cAAc,GAAG;UAAED,MAAM,EAAEC;QAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QACrDO,YAAY,EAAEC,IAAI,CAACC,GAAG,CAAC;MACzB,CAAC,CAAC;IACJ,KAAK,QAAQ;MACX,OAAOf,aAAa,CAAC;QACnBI,SAAS;QACTY,SAAS,EAAEb,KAAK,CAACa,SAAS,IAAI,eAAe;QAC7CH,YAAY,EAAEC,IAAI,CAACC,GAAG,CAAC;MACzB,CAAC,CAAC;IACJ,KAAK,WAAW;MACd,OAAOhB,gBAAgB,CAAC;QACtBK,SAAS;QACT,IAAIE,cAAc,GAAG;UAAED,MAAM,EAAEC;QAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QACrDO,YAAY,EAAEC,IAAI,CAACC,GAAG,CAAC;MACzB,CAAC,CAAC;EACN;EACA,OAAOjB,gBAAgB,CAAC;IAAEM,SAAS;IAAES,YAAY,EAAEC,IAAI,CAACC,GAAG,CAAC;EAAE,CAAC,CAAC;AAClE","ignoreList":[]}

package/lib/module/core/services/pending-session-store.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=pending-session-store.js.map

package/lib/module/core/services/pending-session-store.js.map

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

package/lib/module/core/services/presentation-utils.js

@@ -0,0 +1,7 @@
+"use strict";
+
+export function formatAmount(value) {
+  if (!value) return '—';
+  return `${value.amount} ${value.currency}`;
+}
+//# sourceMappingURL=presentation-utils.js.map

package/lib/module/core/services/presentation-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["formatAmount","value","amount","currency"],"sourceRoot":"../../../../src","sources":["core/services/presentation-utils.ts"],"mappings":";;AAAA,OAAO,SAASA,YAAYA,CAACC,KAAuD,EAAU;EAC5F,IAAI,CAACA,KAAK,EAAE,OAAO,GAAG;EACtB,OAAO,GAAGA,KAAK,CAACC,MAAM,IAAID,KAAK,CAACE,QAAQ,EAAE;AAC5C","ignoreList":[]}

package/lib/module/core/services/redirect-buffer.js

@@ -0,0 +1,33 @@
+"use strict";
+
+/** Module-level buffer for a bank-return URI received before a flow is active. */
+
+let buffered = null;
+/** Fingerprint of the last consumed URI — blocks re-buffer after consume / double-delivery. */
+let lastHandledUri = null;
+export function setBufferedRedirect(uri) {
+  if (uri === buffered?.uri || uri === lastHandledUri) {
+    return;
+  }
+  buffered = {
+    uri
+  };
+}
+export function peekBufferedRedirect() {
+  return buffered?.uri ?? null;
+}
+export function consumeBufferedRedirect() {
+  const value = buffered?.uri ?? null;
+  buffered = null;
+  if (value) {
+    lastHandledUri = value;
+  }
+  return value;
+}
+
+/** @internal Clears buffer state between tests. */
+export function resetRedirectBufferForTests() {
+  buffered = null;
+  lastHandledUri = null;
+}
+//# sourceMappingURL=redirect-buffer.js.map

package/lib/module/core/services/redirect-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["buffered","lastHandledUri","setBufferedRedirect","uri","peekBufferedRedirect","consumeBufferedRedirect","value","resetRedirectBufferForTests"],"sourceRoot":"../../../../src","sources":["core/services/redirect-buffer.ts"],"mappings":";;AAAA;;AAKA,IAAIA,QAAiC,GAAG,IAAI;AAC5C;AACA,IAAIC,cAA6B,GAAG,IAAI;AAExC,OAAO,SAASC,mBAAmBA,CAACC,GAAW,EAAQ;EACrD,IAAIA,GAAG,KAAKH,QAAQ,EAAEG,GAAG,IAAIA,GAAG,KAAKF,cAAc,EAAE;IACnD;EACF;EACAD,QAAQ,GAAG;IAAEG;EAAI,CAAC;AACpB;AAEA,OAAO,SAASC,oBAAoBA,CAAA,EAAkB;EACpD,OAAOJ,QAAQ,EAAEG,GAAG,IAAI,IAAI;AAC9B;AAEA,OAAO,SAASE,uBAAuBA,CAAA,EAAkB;EACvD,MAAMC,KAAK,GAAGN,QAAQ,EAAEG,GAAG,IAAI,IAAI;EACnCH,QAAQ,GAAG,IAAI;EACf,IAAIM,KAAK,EAAE;IACTL,cAAc,GAAGK,KAAK;EACxB;EACA,OAAOA,KAAK;AACd;;AAEA;AACA,OAAO,SAASC,2BAA2BA,CAAA,EAAS;EAClDP,QAAQ,GAAG,IAAI;EACfC,cAAc,GAAG,IAAI;AACvB","ignoreList":[]}

package/lib/module/core/services/user-friendly-messages.js

@@ -0,0 +1,42 @@
+"use strict";
+
+/**
+ * Maps machine-readable error codes to safe user-facing copy.
+ * Raw backend or bank messages must never be shown directly.
+ */
+export function userFriendlyMessageFor(errorCode) {
+  switch (errorCode) {
+    case 'network_timeout':
+      return 'Connection timed out. Please check your connection and try again.';
+    case 'session_expired':
+      return 'Your payment session has expired. Please start again.';
+    case 'session_cancelled':
+      return 'The payment was cancelled.';
+    case 'session_already_completed':
+      return 'This payment has already been completed.';
+    case 'invalid_token':
+      return 'The payment link is invalid or has expired.';
+    case 'bank_unavailable':
+      return 'Your bank is temporarily unavailable. Please try again later.';
+    case 'consent_creation_failed':
+      return 'Unable to initiate the payment. Please try again.';
+    case 'rate_limit_exceeded':
+      return 'Too many attempts. Please wait a moment and try again.';
+    case 'redirect_failed':
+    case 'bank_launch_failed':
+      return 'Unable to open your bank app. Please try again.';
+    case 'session_timeout':
+      return 'The payment timed out waiting for your bank. Please try again.';
+    case 'recovery_exhausted':
+      return 'This payment session could not be recovered. Please start again.';
+    case 'hydration_error':
+    case 'network_error':
+    case 'SP500':
+      return 'Your bank could not complete the payment. Please try again.';
+    case 'authorize_failed':
+      return 'Payment could not be completed. Please try again.';
+    default:
+      return 'Something went wrong. Please try again.';
+  }
+}
+//# sourceMappingURL=user-friendly-messages.js.map

package/lib/module/core/services/user-friendly-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["userFriendlyMessageFor","errorCode"],"sourceRoot":"../../../../src","sources":["core/services/user-friendly-messages.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,SAASA,sBAAsBA,CAACC,SAAiB,EAAU;EAChE,QAAQA,SAAS;IACf,KAAK,iBAAiB;MACpB,OAAO,mEAAmE;IAC5E,KAAK,iBAAiB;MACpB,OAAO,uDAAuD;IAChE,KAAK,mBAAmB;MACtB,OAAO,4BAA4B;IACrC,KAAK,2BAA2B;MAC9B,OAAO,0CAA0C;IACnD,KAAK,eAAe;MAClB,OAAO,6CAA6C;IACtD,KAAK,kBAAkB;MACrB,OAAO,+DAA+D;IACxE,KAAK,yBAAyB;MAC5B,OAAO,mDAAmD;IAC5D,KAAK,qBAAqB;MACxB,OAAO,wDAAwD;IACjE,KAAK,iBAAiB;IACtB,KAAK,oBAAoB;MACvB,OAAO,iDAAiD;IAC1D,KAAK,iBAAiB;MACpB,OAAO,gEAAgE;IACzE,KAAK,oBAAoB;MACvB,OAAO,kEAAkE;IAC3E,KAAK,iBAAiB;IACtB,KAAK,eAAe;IACpB,KAAK,OAAO;MACV,OAAO,6DAA6D;IACtE,KAAK,kBAAkB;MACrB,OAAO,mDAAmD;IAC5D;MACE,OAAO,yCAAyC;EACpD;AACF","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,40 @@
+"use strict";
+
+// Public exports of @spare-technologies/spare-link.
+
+export { SDK_VERSION } from "./version.js";
+export * from "./public/index.js";
+
+// Errors
+export { PaymentApiError, isPaymentApiError } from "./core/errors/payment-api-error.js";
+
+// Models (camelCase SDK shapes)
+
+// Bank-return URI helpers (handy for hosts implementing their own deep-link
+// router that needs to know whether a URI belongs to the payment flow).
+export { isPaymentReturnCallbackUri, extractPaymentReturnErrorCode } from "./core/models/payment-return-params.js";
+
+// API client
+export { LinkApiClient } from "./core/client/link-api-client.js";
+
+// Controller + state machine
+export { PaymentFlowController } from "./core/services/payment-flow-controller.js";
+export { PaymentFlowStates } from "./core/services/payment-flow-state.js";
+
+// Storage interface
+
+// Consent presenter (UI helper, pure function)
+export { presentConsent, summaryFromState, formatAmount, formatCop } from "./core/services/consent-presenter.js";
+export { buildMultiPaymentRules, rulesSectionTitle } from "./core/services/multi-payment-rules-presenter.js";
+export { isMultiPayment, isInternational, supportsConfirmationOfPayee, resolvedPaymentType, consentUiVariant, PaymentType } from "./core/models/payment-type.js";
+
+// UI surface
+export { SpareLinkHost } from "./ui/spare-link-host.js";
+export { PaymentFlowPage } from "./ui/payment-flow-page.js";
+export { usePaymentFlowState } from "./ui/hooks/use-payment-flow-state.js";
+export { BankSelectionScreen, ConsentDetailsScreen, RedirectHandoffScreen, ResumeProcessingScreen, ResultScreen, MandateSetupSuccessScreen } from "./ui/screens/index.js";
+export { Colors, Typography, Spacing, FONT_FAMILY } from "./ui/theme/index.js";
+
+// Native platform integration
+export { collectTelemetry, launchBankRedirect, SecureStorePendingSessionStore, useSpareLinkDeepLinks } from "./internal/index.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SDK_VERSION","PaymentApiError","isPaymentApiError","isPaymentReturnCallbackUri","extractPaymentReturnErrorCode","LinkApiClient","PaymentFlowController","PaymentFlowStates","presentConsent","summaryFromState","formatAmount","formatCop","buildMultiPaymentRules","rulesSectionTitle","isMultiPayment","isInternational","supportsConfirmationOfPayee","resolvedPaymentType","consentUiVariant","PaymentType","SpareLinkHost","PaymentFlowPage","usePaymentFlowState","BankSelectionScreen","ConsentDetailsScreen","RedirectHandoffScreen","ResumeProcessingScreen","ResultScreen","MandateSetupSuccessScreen","Colors","Typography","Spacing","FONT_FAMILY","collectTelemetry","launchBankRedirect","SecureStorePendingSessionStore","useSpareLinkDeepLinks"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;;AAEA,SAASA,WAAW,QAAQ,cAAW;AAEvC,cAAc,mBAAU;;AAExB;AACA,SAASC,eAAe,EAAEC,iBAAiB,QAAQ,oCAAiC;;AAEpF;;AAoBA;AACA;AACA,SACEC,0BAA0B,EAC1BC,6BAA6B,QACxB,wCAAqC;;AAE5C;AACA,SAASC,aAAa,QAAmC,kCAA+B;;AAExF;AACA,SACEC,qBAAqB,QAGhB,4CAAyC;AAChD,SACEC,iBAAiB,QAGZ,uCAAoC;;AAE3C;;AAGA;AACA,SACEC,cAAc,EACdC,gBAAgB,EAChBC,YAAY,EACZC,SAAS,QAQJ,sCAAmC;AAE1C,SACEC,sBAAsB,EACtBC,iBAAiB,QAEZ,kDAA+C;AAEtD,SACEC,cAAc,EACdC,eAAe,EACfC,2BAA2B,EAC3BC,mBAAmB,EACnBC,gBAAgB,EAChBC,WAAW,QAEN,+BAA4B;;AAEnC;AACA,SACEC,aAAa,QAER,yBAAsB;AAC7B,SAASC,eAAe,QAAmC,2BAAwB;AACnF,SAASC,mBAAmB,QAAQ,sCAAmC;AACvE,SACEC,mBAAmB,EAEnBC,oBAAoB,EAEpBC,qBAAqB,EACrBC,sBAAsB,EAEtBC,YAAY,EAEZC,yBAAyB,QAEpB,uBAAc;AACrB,SAASC,MAAM,EAAEC,UAAU,EAAEC,OAAO,EAAEC,WAAW,QAAQ,qBAAY;;AAErE;AACA,SACEC,gBAAgB,EAChBC,kBAAkB,EAElBC,8BAA8B,EAC9BC,qBAAqB,QAChB,qBAAY","ignoreList":[]}

package/lib/module/internal/bank-redirect.js

@@ -0,0 +1,49 @@
+"use strict";
+
+/**
+ * Bank redirect launcher. Port of Flutter `BankRedirect.launch`
+ * (lib/src/internal/bank_redirect.dart).
+ *
+ * Strategy:
+ *   1. If `mobileAppUrl` is provided (e.g. `altareq://authorize?...`), try
+ *      `Linking.openURL` after checking `canOpenURL` — this launches the
+ *      bank's app directly without a browser tab.
+ *   2. Otherwise (or if step 1 fails) open `authorizationUrl` via
+ *      `expo-web-browser`'s in-app browser if installed; fall back to the
+ *      system browser via `Linking.openURL`.
+ */
+import { Linking } from 'react-native';
+import { createLogger } from "./logger.js";
+const log = createLogger('BankRedirect');
+async function loadWebBrowser() {
+  try {
+    return await import('expo-web-browser');
+  } catch {
+    return null;
+  }
+}
+export async function launchBankRedirect(args) {
+  if (args.mobileAppUrl) {
+    log.info('launch: trying mobile app deep link');
+    try {
+      const can = await Linking.canOpenURL(args.mobileAppUrl);
+      if (can) {
+        await Linking.openURL(args.mobileAppUrl);
+        log.info('launch: mobile app deep link succeeded');
+        return;
+      }
+      log.warning('launch: mobile deep link unavailable — falling back to browser');
+    } catch (e) {
+      log.warning(`launch: mobile deep link failed (${e instanceof Error ? e.message : String(e)}) — falling back`);
+    }
+  }
+  const wb = await loadWebBrowser();
+  if (wb?.openBrowserAsync) {
+    log.info('launch: opening authorization URL in in-app browser');
+    await wb.openBrowserAsync(args.authorizationUrl);
+    return;
+  }
+  log.info('launch: opening authorization URL in system browser');
+  await Linking.openURL(args.authorizationUrl);
+}
+//# sourceMappingURL=bank-redirect.js.map

package/lib/module/internal/bank-redirect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Linking","createLogger","log","loadWebBrowser","launchBankRedirect","args","mobileAppUrl","info","can","canOpenURL","openURL","warning","e","Error","message","String","wb","openBrowserAsync","authorizationUrl"],"sourceRoot":"../../../src","sources":["internal/bank-redirect.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,OAAO,QAAQ,cAAc;AACtC,SAASC,YAAY,QAAQ,aAAU;AAEvC,MAAMC,GAAG,GAAGD,YAAY,CAAC,cAAc,CAAC;AAWxC,eAAeE,cAAcA,CAAA,EAAmC;EAC9D,IAAI;IACF,OAAQ,MAAM,MAAM,CAAC,kBAAkB,CAAC;EAC1C,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;AAEA,OAAO,eAAeC,kBAAkBA,CAACC,IAAsB,EAAiB;EAC9E,IAAIA,IAAI,CAACC,YAAY,EAAE;IACrBJ,GAAG,CAACK,IAAI,CAAC,qCAAqC,CAAC;IAC/C,IAAI;MACF,MAAMC,GAAG,GAAG,MAAMR,OAAO,CAACS,UAAU,CAACJ,IAAI,CAACC,YAAY,CAAC;MACvD,IAAIE,GAAG,EAAE;QACP,MAAMR,OAAO,CAACU,OAAO,CAACL,IAAI,CAACC,YAAY,CAAC;QACxCJ,GAAG,CAACK,IAAI,CAAC,wCAAwC,CAAC;QAClD;MACF;MACAL,GAAG,CAACS,OAAO,CAAC,gEAAgE,CAAC;IAC/E,CAAC,CAAC,OAAOC,CAAC,EAAE;MACVV,GAAG,CAACS,OAAO,CACT,oCAAoCC,CAAC,YAAYC,KAAK,GAAGD,CAAC,CAACE,OAAO,GAAGC,MAAM,CAACH,CAAC,CAAC,kBAChF,CAAC;IACH;EACF;EAEA,MAAMI,EAAE,GAAG,MAAMb,cAAc,CAAC,CAAC;EACjC,IAAIa,EAAE,EAAEC,gBAAgB,EAAE;IACxBf,GAAG,CAACK,IAAI,CAAC,qDAAqD,CAAC;IAC/D,MAAMS,EAAE,CAACC,gBAAgB,CAACZ,IAAI,CAACa,gBAAgB,CAAC;IAChD;EACF;EACAhB,GAAG,CAACK,IAAI,CAAC,qDAAqD,CAAC;EAC/D,MAAMP,OAAO,CAACU,OAAO,CAACL,IAAI,CAACa,gBAAgB,CAAC;AAC9C","ignoreList":[]}

package/lib/module/internal/deep-link-listener.js

@@ -0,0 +1,34 @@
+"use strict";
+
+/**
+ * Convenience hook that wires `Linking.addEventListener('url', ...)` +
+ * `Linking.getInitialURL()` to {@link SpareLink.handleRedirect}.
+ */
+import { useEffect } from 'react';
+import { Linking } from 'react-native';
+export function useSpareLinkDeepLinks(spareLink) {
+  useEffect(() => {
+    let removed = false;
+    let lastUrl = null;
+    const handle = url => {
+      if (url === lastUrl) return;
+      lastUrl = url;
+      void spareLink.handleRedirect(url);
+    };
+    const subscription = Linking.addEventListener('url', ({
+      url
+    }) => {
+      handle(url);
+    });
+    void Linking.getInitialURL().then(initial => {
+      if (initial && !removed) {
+        handle(initial);
+      }
+    });
+    return () => {
+      removed = true;
+      subscription.remove();
+    };
+  }, [spareLink]);
+}
+//# sourceMappingURL=deep-link-listener.js.map

package/lib/module/internal/deep-link-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","Linking","useSpareLinkDeepLinks","spareLink","removed","lastUrl","handle","url","handleRedirect","subscription","addEventListener","getInitialURL","then","initial","remove"],"sourceRoot":"../../../src","sources":["internal/deep-link-listener.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,SAASA,SAAS,QAAQ,OAAO;AACjC,SAASC,OAAO,QAAQ,cAAc;AAGtC,OAAO,SAASC,qBAAqBA,CAACC,SAAoB,EAAQ;EAChEH,SAAS,CAAC,MAAM;IACd,IAAII,OAAO,GAAG,KAAK;IACnB,IAAIC,OAAsB,GAAG,IAAI;IACjC,MAAMC,MAAM,GAAIC,GAAW,IAAK;MAC9B,IAAIA,GAAG,KAAKF,OAAO,EAAE;MACrBA,OAAO,GAAGE,GAAG;MACb,KAAKJ,SAAS,CAACK,cAAc,CAACD,GAAG,CAAC;IACpC,CAAC;IACD,MAAME,YAAY,GAAGR,OAAO,CAACS,gBAAgB,CAAC,KAAK,EAAE,CAAC;MAAEH;IAAI,CAAC,KAAK;MAChED,MAAM,CAACC,GAAG,CAAC;IACb,CAAC,CAAC;IACF,KAAKN,OAAO,CAACU,aAAa,CAAC,CAAC,CAACC,IAAI,CAAEC,OAAO,IAAK;MAC7C,IAAIA,OAAO,IAAI,CAACT,OAAO,EAAE;QACvBE,MAAM,CAACO,OAAO,CAAC;MACjB;IACF,CAAC,CAAC;IACF,OAAO,MAAM;MACXT,OAAO,GAAG,IAAI;MACdK,YAAY,CAACK,MAAM,CAAC,CAAC;IACvB,CAAC;EACH,CAAC,EAAE,CAACX,SAAS,CAAC,CAAC;AACjB","ignoreList":[]}

package/lib/module/internal/event-emitter.js

@@ -0,0 +1,32 @@
+"use strict";
+
+/** Minimal typed pub/sub — TypeScript equivalent of Dart's broadcast Stream. */
+
+export function createEventEmitter() {
+  const listeners = new Set();
+  let closed = false;
+  function subscribe(listener) {
+    if (closed) return () => {};
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  }
+  return {
+    subscribe,
+    listen: subscribe,
+    emit(event) {
+      if (closed) return;
+      for (const listener of listeners) {
+        try {
+          listener(event);
+        } catch {
+          /* swallow — same as Flutter/Dart stream */
+        }
+      }
+    },
+    dispose() {
+      closed = true;
+      listeners.clear();
+    }
+  };
+}
+//# sourceMappingURL=event-emitter.js.map

package/lib/module/internal/event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createEventEmitter","listeners","Set","closed","subscribe","listener","add","delete","listen","emit","event","dispose","clear"],"sourceRoot":"../../../src","sources":["internal/event-emitter.ts"],"mappings":";;AAAA;;AAUA,OAAO,SAASA,kBAAkBA,CAAA,EAGhC;EACA,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAqB,CAAC;EAC/C,IAAIC,MAAM,GAAG,KAAK;EAElB,SAASC,SAASA,CAACC,QAA4B,EAAe;IAC5D,IAAIF,MAAM,EAAE,OAAO,MAAM,CAAC,CAAC;IAC3BF,SAAS,CAACK,GAAG,CAACD,QAAQ,CAAC;IACvB,OAAO,MAAMJ,SAAS,CAACM,MAAM,CAACF,QAAQ,CAAC;EACzC;EAEA,OAAO;IACLD,SAAS;IACTI,MAAM,EAAEJ,SAAS;IACjBK,IAAIA,CAACC,KAAK,EAAE;MACV,IAAIP,MAAM,EAAE;MACZ,KAAK,MAAME,QAAQ,IAAIJ,SAAS,EAAE;QAChC,IAAI;UACFI,QAAQ,CAACK,KAAK,CAAC;QACjB,CAAC,CAAC,MAAM;UACN;QAAA;MAEJ;IACF,CAAC;IACDC,OAAOA,CAAA,EAAG;MACRR,MAAM,GAAG,IAAI;MACbF,SAAS,CAACW,KAAK,CAAC,CAAC;IACnB;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/internal/index.js

@@ -0,0 +1,7 @@
+"use strict";
+
+export { collectTelemetry } from "./telemetry-collector.js";
+export { launchBankRedirect } from "./bank-redirect.js";
+export { SecureStorePendingSessionStore } from "./secure-store-pending-session-store.js";
+export { useSpareLinkDeepLinks } from "./deep-link-listener.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["collectTelemetry","launchBankRedirect","SecureStorePendingSessionStore","useSpareLinkDeepLinks"],"sourceRoot":"../../../src","sources":["internal/index.ts"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,0BAAuB;AACxD,SAASC,kBAAkB,QAA+B,oBAAiB;AAC3E,SAASC,8BAA8B,QAAQ,yCAAsC;AACrF,SAASC,qBAAqB,QAAQ,yBAAsB","ignoreList":[]}

package/lib/module/internal/logger.js

@@ -0,0 +1,61 @@
+"use strict";
+
+const LEVEL_RANK = {
+  fine: 10,
+  info: 20,
+  warning: 30,
+  severe: 40
+};
+let config = null;
+function isDevBuild() {
+  if (typeof __DEV__ === 'boolean') return __DEV__;
+  return process.env.NODE_ENV !== 'production';
+}
+function defaultLevel() {
+  return isDevBuild() ? 'info' : 'severe';
+}
+function defaultSink() {
+  return record => {
+    const line = `${record.level.toUpperCase()}: ${record.time.toISOString()}: ${record.loggerName}: ${record.message}`;
+    if (record.level === 'severe' || record.level === 'warning') {
+      console.warn(line);
+    } else {
+      console.info(line);
+    }
+  };
+}
+
+/** Configure SDK logging — mirrors Flutter `Logger.root.level` + `onRecord.listen`. */
+export function configureSpareLinkLogging(opts) {
+  config = {
+    level: opts.level ?? defaultLevel(),
+    sink: opts.sink ?? defaultSink()
+  };
+}
+
+/** @internal test helper */
+export function resetSpareLinkLoggingForTests() {
+  config = null;
+}
+export function createLogger(loggerName) {
+  const emit = (level, message) => {
+    const active = config ?? {
+      level: defaultLevel(),
+      sink: () => {}
+    };
+    if (LEVEL_RANK[level] < LEVEL_RANK[active.level]) return;
+    active.sink({
+      level,
+      loggerName,
+      message,
+      time: new Date()
+    });
+  };
+  return {
+    fine: m => emit('fine', m),
+    info: m => emit('info', m),
+    warning: m => emit('warning', m),
+    severe: m => emit('severe', m)
+  };
+}
+//# sourceMappingURL=logger.js.map

package/lib/module/internal/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LEVEL_RANK","fine","info","warning","severe","config","isDevBuild","__DEV__","process","env","NODE_ENV","defaultLevel","defaultSink","record","line","level","toUpperCase","time","toISOString","loggerName","message","console","warn","configureSpareLinkLogging","opts","sink","resetSpareLinkLoggingForTests","createLogger","emit","active","Date","m"],"sourceRoot":"../../../src","sources":["internal/logger.ts"],"mappings":";;AAEA,MAAMA,UAA6C,GAAG;EACpDC,IAAI,EAAE,EAAE;EACRC,IAAI,EAAE,EAAE;EACRC,OAAO,EAAE,EAAE;EACXC,MAAM,EAAE;AACV,CAAC;AAgBD,IAAIC,MAA4B,GAAG,IAAI;AAEvC,SAASC,UAAUA,CAAA,EAAY;EAC7B,IAAI,OAAOC,OAAO,KAAK,SAAS,EAAE,OAAOA,OAAO;EAChD,OAAOC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY;AAC9C;AAEA,SAASC,YAAYA,CAAA,EAAsB;EACzC,OAAOL,UAAU,CAAC,CAAC,GAAG,MAAM,GAAG,QAAQ;AACzC;AAEA,SAASM,WAAWA,CAAA,EAAqB;EACvC,OAAQC,MAAM,IAAK;IACjB,MAAMC,IAAI,GAAG,GAAGD,MAAM,CAACE,KAAK,CAACC,WAAW,CAAC,CAAC,KAAKH,MAAM,CAACI,IAAI,CAACC,WAAW,CAAC,CAAC,KAAKL,MAAM,CAACM,UAAU,KAAKN,MAAM,CAACO,OAAO,EAAE;IACnH,IAAIP,MAAM,CAACE,KAAK,KAAK,QAAQ,IAAIF,MAAM,CAACE,KAAK,KAAK,SAAS,EAAE;MAC3DM,OAAO,CAACC,IAAI,CAACR,IAAI,CAAC;IACpB,CAAC,MAAM;MACLO,OAAO,CAACnB,IAAI,CAACY,IAAI,CAAC;IACpB;EACF,CAAC;AACH;;AAEA;AACA,OAAO,SAASS,yBAAyBA,CAACC,IAGzC,EAAQ;EACPnB,MAAM,GAAG;IACPU,KAAK,EAAES,IAAI,CAACT,KAAK,IAAIJ,YAAY,CAAC,CAAC;IACnCc,IAAI,EAAED,IAAI,CAACC,IAAI,IAAIb,WAAW,CAAC;EACjC,CAAC;AACH;;AAEA;AACA,OAAO,SAASc,6BAA6BA,CAAA,EAAS;EACpDrB,MAAM,GAAG,IAAI;AACf;AASA,OAAO,SAASsB,YAAYA,CAACR,UAAkB,EAAmB;EAChE,MAAMS,IAAI,GAAGA,CAACb,KAAwB,EAAEK,OAAe,KAAK;IAC1D,MAAMS,MAAM,GAAGxB,MAAM,IAAI;MAAEU,KAAK,EAAEJ,YAAY,CAAC,CAAC;MAAEc,IAAI,EAAEA,CAAA,KAAM,CAAC;IAAE,CAAC;IAClE,IAAIzB,UAAU,CAACe,KAAK,CAAC,GAAGf,UAAU,CAAC6B,MAAM,CAACd,KAAK,CAAC,EAAE;IAClDc,MAAM,CAACJ,IAAI,CAAC;MAAEV,KAAK;MAAEI,UAAU;MAAEC,OAAO;MAAEH,IAAI,EAAE,IAAIa,IAAI,CAAC;IAAE,CAAC,CAAC;EAC/D,CAAC;EACD,OAAO;IACL7B,IAAI,EAAG8B,CAAC,IAAKH,IAAI,CAAC,MAAM,EAAEG,CAAC,CAAC;IAC5B7B,IAAI,EAAG6B,CAAC,IAAKH,IAAI,CAAC,MAAM,EAAEG,CAAC,CAAC;IAC5B5B,OAAO,EAAG4B,CAAC,IAAKH,IAAI,CAAC,SAAS,EAAEG,CAAC,CAAC;IAClC3B,MAAM,EAAG2B,CAAC,IAAKH,IAAI,CAAC,QAAQ,EAAEG,CAAC;EACjC,CAAC;AACH","ignoreList":[]}

package/lib/module/internal/redact-uri.js

@@ -0,0 +1,21 @@
+"use strict";
+
+const SENSITIVE_QUERY_KEYS = new Set(['exchange_code', 'error_description']);
+
+/** Redacts sensitive query params before logging bank-return URIs. */
+export function redactPaymentReturnUri(uri) {
+  try {
+    const parsed = new URL(uri);
+    let changed = false;
+    for (const key of SENSITIVE_QUERY_KEYS) {
+      if (parsed.searchParams.has(key)) {
+        parsed.searchParams.set(key, '[REDACTED]');
+        changed = true;
+      }
+    }
+    return changed ? parsed.toString() : uri;
+  } catch {
+    return '[invalid-uri]';
+  }
+}
+//# sourceMappingURL=redact-uri.js.map

package/lib/module/internal/redact-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SENSITIVE_QUERY_KEYS","Set","redactPaymentReturnUri","uri","parsed","URL","changed","key","searchParams","has","set","toString"],"sourceRoot":"../../../src","sources":["internal/redact-uri.ts"],"mappings":";;AAAA,MAAMA,oBAAoB,GAAG,IAAIC,GAAG,CAAC,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;;AAE5E;AACA,OAAO,SAASC,sBAAsBA,CAACC,GAAW,EAAU;EAC1D,IAAI;IACF,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAACF,GAAG,CAAC;IAC3B,IAAIG,OAAO,GAAG,KAAK;IACnB,KAAK,MAAMC,GAAG,IAAIP,oBAAoB,EAAE;MACtC,IAAII,MAAM,CAACI,YAAY,CAACC,GAAG,CAACF,GAAG,CAAC,EAAE;QAChCH,MAAM,CAACI,YAAY,CAACE,GAAG,CAACH,GAAG,EAAE,YAAY,CAAC;QAC1CD,OAAO,GAAG,IAAI;MAChB;IACF;IACA,OAAOA,OAAO,GAAGF,MAAM,CAACO,QAAQ,CAAC,CAAC,GAAGR,GAAG;EAC1C,CAAC,CAAC,MAAM;IACN,OAAO,eAAe;EACxB;AACF","ignoreList":[]}

package/lib/module/internal/secure-store-pending-session-store.js

@@ -0,0 +1,88 @@
+"use strict";
+
+/**
+ * Production `PendingSessionStore` backed by expo-secure-store. Persists a
+ * single in-flight payment session so the SDK can recover after cold start.
+ */
+
+import { createLogger } from "./logger.js";
+const log = createLogger('SecureStorePendingSessionStore');
+const KEYS = {
+  sessionId: 'spare_link_session_id',
+  bankId: 'spare_link_bank_id',
+  authUrl: 'spare_link_auth_url',
+  consentAt: 'spare_link_consent_at',
+  recoveryAttempts: 'spare_link_recovery_attempts',
+  merchantRef: 'spare_link_merchant_ref'
+};
+async function defaultLoader() {
+  try {
+    return await import('expo-secure-store');
+  } catch (err) {
+    throw new Error(`SecureStorePendingSessionStore requires 'expo-secure-store' — install it in your app. (${err instanceof Error ? err.message : String(err)})`);
+  }
+}
+export class SecureStorePendingSessionStore {
+  secureStore = null;
+  /**
+   * Promise chain serializing every write/clear so a `clear()` racing a
+   * partial `save()` can't leave the store in a half-written state.
+   */
+  writeQueue = Promise.resolve();
+
+  /**
+   * @param moduleLoader Optional override returning the secure-store module.
+   *                     Defaults to dynamically importing `expo-secure-store`.
+   *                     Tests inject an in-memory fake.
+   */
+  constructor(moduleLoader = defaultLoader) {
+    this.loader = moduleLoader;
+  }
+  get module() {
+    if (!this.secureStore) this.secureStore = this.loader();
+    return this.secureStore;
+  }
+
+  /** Serializes write operations so save+clear can't interleave. */
+  enqueueWrite(op) {
+    const next = this.writeQueue.then(op, op);
+    this.writeQueue = next.catch(() => {
+      // Swallow so one failure doesn't poison the queue.
+    });
+    return next;
+  }
+  save(record) {
+    return this.enqueueWrite(async () => {
+      const s = await this.module;
+      await Promise.all([s.setItemAsync(KEYS.sessionId, record.sessionId), s.setItemAsync(KEYS.bankId, record.selectedBankId), s.setItemAsync(KEYS.authUrl, record.authorizationUrl), record.consentAt !== undefined ? s.setItemAsync(KEYS.consentAt, String(record.consentAt)) : s.deleteItemAsync(KEYS.consentAt), s.setItemAsync(KEYS.recoveryAttempts, String(record.recoveryAttempts)), record.merchantRef ? s.setItemAsync(KEYS.merchantRef, record.merchantRef) : s.deleteItemAsync(KEYS.merchantRef)]);
+    });
+  }
+  async load() {
+    // Wait for any pending writes to settle so we read a consistent snapshot.
+    await this.writeQueue.catch(() => undefined);
+    const s = await this.module;
+    const [sessionId, bankId, authUrl, consentAtRaw, attemptsRaw, merchantRef] = await Promise.all([s.getItemAsync(KEYS.sessionId), s.getItemAsync(KEYS.bankId), s.getItemAsync(KEYS.authUrl), s.getItemAsync(KEYS.consentAt), s.getItemAsync(KEYS.recoveryAttempts), s.getItemAsync(KEYS.merchantRef)]);
+    if (!sessionId || !bankId || !authUrl) {
+      log.fine('load: no pending session found');
+      return null;
+    }
+    const consentAt = consentAtRaw ? Number(consentAtRaw) : undefined;
+    const recoveryAttempts = attemptsRaw ? Number(attemptsRaw) : 0;
+    const record = {
+      sessionId,
+      selectedBankId: bankId,
+      authorizationUrl: authUrl,
+      recoveryAttempts: Number.isFinite(recoveryAttempts) ? recoveryAttempts : 0
+    };
+    if (consentAt !== undefined && Number.isFinite(consentAt)) record.consentAt = consentAt;
+    if (merchantRef) record.merchantRef = merchantRef;
+    return record;
+  }
+  clear() {
+    return this.enqueueWrite(async () => {
+      const s = await this.module;
+      await Promise.all([s.deleteItemAsync(KEYS.sessionId), s.deleteItemAsync(KEYS.bankId), s.deleteItemAsync(KEYS.authUrl), s.deleteItemAsync(KEYS.consentAt), s.deleteItemAsync(KEYS.recoveryAttempts), s.deleteItemAsync(KEYS.merchantRef)]);
+    });
+  }
+}
+//# sourceMappingURL=secure-store-pending-session-store.js.map

package/lib/module/internal/secure-store-pending-session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createLogger","log","KEYS","sessionId","bankId","authUrl","consentAt","recoveryAttempts","merchantRef","defaultLoader","err","Error","message","String","SecureStorePendingSessionStore","secureStore","writeQueue","Promise","resolve","constructor","moduleLoader","loader","module","enqueueWrite","op","next","then","catch","save","record","s","all","setItemAsync","selectedBankId","authorizationUrl","undefined","deleteItemAsync","load","consentAtRaw","attemptsRaw","getItemAsync","fine","Number","isFinite","clear"],"sourceRoot":"../../../src","sources":["internal/secure-store-pending-session-store.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/internal/telemetry-collector.js

@@ -0,0 +1,75 @@
+"use strict";
+
+/**
+ * Best-effort device + geolocation telemetry collector. Each call site catches
+ * runtime failures so a permission denial or missing native module degrades
+ * to a partial payload instead of throwing.
+ */
+import { Platform } from 'react-native';
+import { SDK_VERSION } from "../version.js";
+import { createLogger } from "./logger.js";
+const log = createLogger('TelemetryCollector');
+const LOCATION_TIMEOUT_MS = 5_000;
+async function loadDevice() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    return require('expo-device');
+  } catch {
+    return null;
+  }
+}
+async function loadLocation() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    return require('expo-location');
+  } catch {
+    return null;
+  }
+}
+export async function collectTelemetry() {
+  log.fine('collect: gathering device telemetry');
+  const [deviceMod, locationMod] = await Promise.all([loadDevice(), loadLocation()]);
+  const payload = {
+    platform: 'react_native',
+    sdk_version: SDK_VERSION,
+    os: Platform.OS
+  };
+  const model = deviceMod?.modelName ?? null;
+  const osVersion = deviceMod?.osVersion ?? null;
+  if (model && osVersion) {
+    payload.device_fingerprint = `${model}_${osVersion}`;
+  }
+  if (locationMod) {
+    try {
+      const permission = await locationMod.requestForegroundPermissionsAsync();
+      if (permission.status === 'granted') {
+        const position = await Promise.race([locationMod.getCurrentPositionAsync({
+          accuracy: 3
+        }), new Promise(resolve => setTimeout(() => resolve(null), LOCATION_TIMEOUT_MS))]);
+        if (position) {
+          payload.geolocation = {
+            latitude: position.coords.latitude,
+            longitude: position.coords.longitude,
+            accuracy_m: position.coords.accuracy
+          };
+        } else {
+          payload.geolocation = {
+            unavailable: 'timeout'
+          };
+        }
+      } else {
+        payload.geolocation = {
+          unavailable: 'permission_denied'
+        };
+      }
+    } catch (e) {
+      log.warning(`collect: geolocation failed — ${e instanceof Error ? e.message : String(e)}`);
+      payload.geolocation = {
+        unavailable: 'error'
+      };
+    }
+  }
+  log.fine(`collect: payload keys=${Object.keys(payload).join(',')}`);
+  return payload;
+}
+//# sourceMappingURL=telemetry-collector.js.map

package/lib/module/internal/telemetry-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","SDK_VERSION","createLogger","log","LOCATION_TIMEOUT_MS","loadDevice","require","loadLocation","collectTelemetry","fine","deviceMod","locationMod","Promise","all","payload","platform","sdk_version","os","OS","model","modelName","osVersion","device_fingerprint","permission","requestForegroundPermissionsAsync","status","position","race","getCurrentPositionAsync","accuracy","resolve","setTimeout","geolocation","latitude","coords","longitude","accuracy_m","unavailable","e","warning","Error","message","String","Object","keys","join"],"sourceRoot":"../../../src","sources":["internal/telemetry-collector.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA,SAASA,QAAQ,QAAQ,cAAc;AACvC,SAASC,WAAW,QAAQ,eAAY;AACxC,SAASC,YAAY,QAAQ,aAAU;AAEvC,MAAMC,GAAG,GAAGD,YAAY,CAAC,oBAAoB,CAAC;AAE9C,MAAME,mBAAmB,GAAG,KAAK;AAcjC,eAAeC,UAAUA,CAAA,EAA+B;EACtD,IAAI;IACF;IACA,OAAOC,OAAO,CAAC,aAAa,CAAC;EAC/B,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;AAEA,eAAeC,YAAYA,CAAA,EAAiC;EAC1D,IAAI;IACF;IACA,OAAOD,OAAO,CAAC,eAAe,CAAC;EACjC,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;AAEA,OAAO,eAAeE,gBAAgBA,CAAA,EAAqC;EACzEL,GAAG,CAACM,IAAI,CAAC,qCAAqC,CAAC;EAC/C,MAAM,CAACC,SAAS,EAAEC,WAAW,CAAC,GAAG,MAAMC,OAAO,CAACC,GAAG,CAAC,CAACR,UAAU,CAAC,CAAC,EAAEE,YAAY,CAAC,CAAC,CAAC,CAAC;EAElF,MAAMO,OAAgC,GAAG;IACvCC,QAAQ,EAAE,cAAc;IACxBC,WAAW,EAAEf,WAAW;IACxBgB,EAAE,EAAEjB,QAAQ,CAACkB;EACf,CAAC;EAED,MAAMC,KAAK,GAAGT,SAAS,EAAEU,SAAS,IAAI,IAAI;EAC1C,MAAMC,SAAS,GAAGX,SAAS,EAAEW,SAAS,IAAI,IAAI;EAC9C,IAAIF,KAAK,IAAIE,SAAS,EAAE;IACtBP,OAAO,CAACQ,kBAAkB,GAAG,GAAGH,KAAK,IAAIE,SAAS,EAAE;EACtD;EAEA,IAAIV,WAAW,EAAE;IACf,IAAI;MACF,MAAMY,UAAU,GAAG,MAAMZ,WAAW,CAACa,iCAAiC,CAAC,CAAC;MACxE,IAAID,UAAU,CAACE,MAAM,KAAK,SAAS,EAAE;QACnC,MAAMC,QAAQ,GAAG,MAAMd,OAAO,CAACe,IAAI,CAEzB,CACRhB,WAAW,CAACiB,uBAAuB,CAAC;UAAEC,QAAQ,EAAE;QAAE,CAAC,CAAC,EACpD,IAAIjB,OAAO,CAAEkB,OAAO,IAAKC,UAAU,CAAC,MAAMD,OAAO,CAAC,IAAI,CAAC,EAAE1B,mBAAmB,CAAC,CAAC,CAC/E,CAAC;QACF,IAAIsB,QAAQ,EAAE;UACZZ,OAAO,CAACkB,WAAW,GAAG;YACpBC,QAAQ,EAAEP,QAAQ,CAACQ,MAAM,CAACD,QAAQ;YAClCE,SAAS,EAAET,QAAQ,CAACQ,MAAM,CAACC,SAAS;YACpCC,UAAU,EAAEV,QAAQ,CAACQ,MAAM,CAACL;UAC9B,CAAC;QACH,CAAC,MAAM;UACLf,OAAO,CAACkB,WAAW,GAAG;YAAEK,WAAW,EAAE;UAAU,CAAC;QAClD;MACF,CAAC,MAAM;QACLvB,OAAO,CAACkB,WAAW,GAAG;UAAEK,WAAW,EAAE;QAAoB,CAAC;MAC5D;IACF,CAAC,CAAC,OAAOC,CAAC,EAAE;MACVnC,GAAG,CAACoC,OAAO,CAAC,iCAAiCD,CAAC,YAAYE,KAAK,GAAGF,CAAC,CAACG,OAAO,GAAGC,MAAM,CAACJ,CAAC,CAAC,EAAE,CAAC;MAC1FxB,OAAO,CAACkB,WAAW,GAAG;QAAEK,WAAW,EAAE;MAAQ,CAAC;IAChD;EACF;EAEAlC,GAAG,CAACM,IAAI,CAAC,yBAAyBkC,MAAM,CAACC,IAAI,CAAC9B,OAAO,CAAC,CAAC+B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;EACnE,OAAO/B,OAAO;AAChB","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}