@quiltt/core 5.1.2 → 5.2.0

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # @quiltt/core
 
+## 5.2.0
+
+### Minor Changes
+
+- [#427](https://github.com/quiltt/quiltt-js/pull/427) [`6d4b768`](https://github.com/quiltt/quiltt-js/commit/6d4b7683f49d0a6e649a4bdfaff0398669102a63) Thanks [@zubairaziz](https://github.com/zubairaziz)! - Bump minor version to be consistent with SemVer standards
+
+## 5.1.3
+
+### Patch Changes
+
+- [#425](https://github.com/quiltt/quiltt-js/pull/425) [`c684b3b`](https://github.com/quiltt/quiltt-js/commit/c684b3b5f6ea2829e2abfa2a75c0d430edad66a5) Thanks [@zubairaziz](https://github.com/zubairaziz)! - Add @quiltt/capacitor package for Ionic and Capacitor apps
+
+  - Framework-agnostic by default — works with Vue, Angular, Svelte, or vanilla JS
+  - Vue 3 components via `@quiltt/capacitor/vue` subpath
+  - React components via `@quiltt/capacitor/react` subpath
+  - Native iOS (Swift) and Android (Kotlin) plugins for OAuth deep linking
+  - Supports Capacitor 6, 7, and 8
+
+  Add @quiltt/vue package for Vue 3 applications
+
+  - `QuilttPlugin` for session management via Vue's provide/inject
+  - `useQuilttSession` composable for authentication
+  - `useQuilttConnector` composable for programmatic control
+  - `QuilttButton`, `QuilttConnector`, `QuilttContainer` components
+  - Add `@quiltt/capacitor/vue` entry point for Capacitor apps
+
+  Rename `oauthRedirectUrl` to `appLauncherUrl` for mobile OAuth flows
+
+  This change introduces `appLauncherUrl` as the new preferred property name for specifying the Universal Link (iOS) or App Link (Android) that redirects users back to your app after OAuth authentication.
+
+  **Deprecation Warning:** The `oauthRedirectUrl` property is now deprecated but remains fully functional for backwards compatibility. Existing code using `oauthRedirectUrl` will continue to work without modifications.
+
+  **Migration:**
+
+  - Replace `oauthRedirectUrl` with `appLauncherUrl` in your component props
+  - The behavior remains identical; only the property name has changed
+
+  **Example:**
+
+  ```tsx
+  // Before (deprecated, still works)
+  <QuilttConnector oauthRedirectUrl="https://myapp.com/callback" />
+
+  // After (recommended)
+  <QuilttConnector appLauncherUrl="https://myapp.com/callback" />
+  ```
+
 ## 5.1.2
 
 ### Patch Changes

package/README.md

@@ -5,7 +5,7 @@
 
 `@quiltt/core` provides essential primitives for building Javascript-based applications with Quiltt. It provides an Auth API client and modules for handling JSON Web Tokens (JWT), observables, storage management, timeouts, API handling, and Typescript types.
 
-This package is used by both [`@quiltt/react`](../react#readme) and [`@quiltt/react-native`](../react-native#readme). If you bundle it separately, we recommend keeping versions in sync to avoid issues with mismatched dependencies.
+This package is used by [`@quiltt/react`](../react#readme), [`@quiltt/vue`](../vue#readme), and [`@quiltt/react-native`](../react-native#readme). If you bundle it separately, we recommend keeping versions in sync to avoid issues with mismatched dependencies.
 
 For general project information and contributing guidelines, see the [main repository README](../../README.md).
 
@@ -112,4 +112,6 @@ For information on how to contribute to this project, please refer to the [repos
 ## Related Packages
 
 - [`@quiltt/react`](../react#readme) - React components and hooks
+- [`@quiltt/vue`](../vue#readme) - Vue 3 components and composables
 - [`@quiltt/react-native`](../react-native#readme) - React Native and Expo components
+- [`@quiltt/capacitor`](../capacitor#readme) - Capacitor plugin and mobile framework adapters

package/dist/api/browser.d.ts

@@ -101,7 +101,15 @@ type ConnectorSDKCallbackMetadata = {
 type ConnectorSDKConnectOptions = ConnectorSDKCallbacks & {
     /** The Institution ID or search term to connect */
     institution?: string;
-    /** The OAuth redirect URL for mobile or embedded webview flows */
+    /**
+     * The app launcher URL for mobile OAuth flows.
+     * This URL should be a Universal Link (iOS) or App Link (Android) that redirects back to your app.
+     */
+    appLauncherUrl?: string;
+    /**
+     * @deprecated Use `appLauncherUrl` instead. This property will be removed in a future version.
+     * The OAuth redirect URL for mobile or embedded webview flows.
+     */
     oauthRedirectUrl?: string;
 };
 /**
@@ -111,7 +119,15 @@ type ConnectorSDKConnectOptions = ConnectorSDKCallbacks & {
 type ConnectorSDKReconnectOptions = ConnectorSDKCallbacks & {
     /** The ID of the Connection to reconnect */
     connectionId: string;
-    /** The OAuth redirect URL for mobile or embedded webview flows */
+    /**
+     * The app launcher URL for mobile OAuth flows.
+     * This URL should be a Universal Link (iOS) or App Link (Android) that redirects back to your app.
+     */
+    appLauncherUrl?: string;
+    /**
+     * @deprecated Use `appLauncherUrl` instead. This property will be removed in a future version.
+     * The OAuth redirect URL for mobile or embedded webview flows.
+     */
     oauthRedirectUrl?: string;
 };
 /** Options to initialize Connector
@@ -126,7 +142,15 @@ type ConnectorSDKConnectorOptions = ConnectorSDKCallbacks & {
     connectionId?: string;
     /** The nonce to use for the script tag */
     nonce?: string;
-    /** The OAuth redirect URL for mobile or embedded webview flows */
+    /**
+     * The app launcher URL for mobile OAuth flows.
+     * This URL should be a Universal Link (iOS) or App Link (Android) that redirects back to your app.
+     */
+    appLauncherUrl?: string;
+    /**
+     * @deprecated Use `appLauncherUrl` instead. This property will be removed in a future version.
+     * The OAuth redirect URL for mobile or embedded webview flows.
+     */
     oauthRedirectUrl?: string;
 };
 

package/dist/api/rest/index.cjs

@@ -37,15 +37,20 @@ var crossfetch__default = /*#__PURE__*/_interopDefault(crossfetch);
 const effectiveFetch = typeof fetch === 'undefined' ? crossfetch__default.default : fetch;
 const RETRY_DELAY = 150 // ms
 ;
-const RETRIES = 10 // 150, 300, 450, 600, 750, 900, 1050, 1200, 1350, 1500 = 8.250s
+const MAX_RETRY_DELAY = 1500 // ms
 ;
+const RETRIES = 10;
+const getRetryDelay = (attemptNumber)=>{
+    const exponentialDelay = RETRY_DELAY * 2 ** (attemptNumber - 1);
+    return Math.min(exponentialDelay, MAX_RETRY_DELAY);
+};
 /**
  * A wrapper around the native `fetch` function that adds automatic retries on failure, including network errors and HTTP 429 responses.
  * Now treats any response with status < 500 as valid.
  */ const fetchWithRetry = async (url, options = {
     retry: false
 })=>{
-    const { retry, retriesRemaining, validateStatus = (status)=>status >= 200 && status < 300, ...fetchOptions } = options;
+    const { retry, retriesRemaining, initialRetries, validateStatus = (status)=>status >= 200 && status < 300, ...fetchOptions } = options;
     try {
         const response = await effectiveFetch(url, fetchOptions);
         const isResponseOk = validateStatus(response.status);
@@ -60,18 +65,27 @@ const RETRIES = 10 // 150, 300, 450, 600, 750, 900, 1050, 1200, 1350, 1500 = 8.2
         }
         // If validateStatus fails, and retry is enabled, prepare to retry for eligible status codes
         if (retry && (response.status >= 500 || response.status === 429)) {
-            throw new Error('Retryable failure');
+            const error = new Error(`HTTP error with status ${response.status}`);
+            error.retryable = true;
+            throw error;
         }
-        throw new Error(`HTTP error with status ${response.status}`);
+        const error = new Error(`HTTP error with status ${response.status}`);
+        error.retryable = false;
+        throw error;
     } catch (error) {
-        if (retry) {
+        const retryableError = error;
+        const shouldRetry = retry && retryableError.retryable !== false;
+        if (shouldRetry) {
             const currentRetriesRemaining = retriesRemaining !== undefined ? retriesRemaining : RETRIES;
+            const totalRetries = initialRetries ?? currentRetriesRemaining;
             if (currentRetriesRemaining > 0) {
-                const delayTime = RETRY_DELAY * (RETRIES - currentRetriesRemaining);
+                const attemptNumber = totalRetries - currentRetriesRemaining + 1;
+                const delayTime = getRetryDelay(attemptNumber);
                 await new Promise((resolve)=>setTimeout(resolve, delayTime));
                 return fetchWithRetry(url, {
                     ...options,
-                    retriesRemaining: currentRetriesRemaining - 1
+                    retriesRemaining: currentRetriesRemaining - 1,
+                    initialRetries: totalRetries
                 });
             }
         }

package/dist/api/rest/index.js

@@ -31,15 +31,20 @@ import crossfetch from 'cross-fetch';
 const effectiveFetch = typeof fetch === 'undefined' ? crossfetch : fetch;
 const RETRY_DELAY = 150 // ms
 ;
-const RETRIES = 10 // 150, 300, 450, 600, 750, 900, 1050, 1200, 1350, 1500 = 8.250s
+const MAX_RETRY_DELAY = 1500 // ms
 ;
+const RETRIES = 10;
+const getRetryDelay = (attemptNumber)=>{
+    const exponentialDelay = RETRY_DELAY * 2 ** (attemptNumber - 1);
+    return Math.min(exponentialDelay, MAX_RETRY_DELAY);
+};
 /**
  * A wrapper around the native `fetch` function that adds automatic retries on failure, including network errors and HTTP 429 responses.
  * Now treats any response with status < 500 as valid.
  */ const fetchWithRetry = async (url, options = {
     retry: false
 })=>{
-    const { retry, retriesRemaining, validateStatus = (status)=>status >= 200 && status < 300, ...fetchOptions } = options;
+    const { retry, retriesRemaining, initialRetries, validateStatus = (status)=>status >= 200 && status < 300, ...fetchOptions } = options;
     try {
         const response = await effectiveFetch(url, fetchOptions);
         const isResponseOk = validateStatus(response.status);
@@ -54,18 +59,27 @@ const RETRIES = 10 // 150, 300, 450, 600, 750, 900, 1050, 1200, 1350, 1500 = 8.2
         }
         // If validateStatus fails, and retry is enabled, prepare to retry for eligible status codes
         if (retry && (response.status >= 500 || response.status === 429)) {
-            throw new Error('Retryable failure');
+            const error = new Error(`HTTP error with status ${response.status}`);
+            error.retryable = true;
+            throw error;
         }
-        throw new Error(`HTTP error with status ${response.status}`);
+        const error = new Error(`HTTP error with status ${response.status}`);
+        error.retryable = false;
+        throw error;
     } catch (error) {
-        if (retry) {
+        const retryableError = error;
+        const shouldRetry = retry && retryableError.retryable !== false;
+        if (shouldRetry) {
             const currentRetriesRemaining = retriesRemaining !== undefined ? retriesRemaining : RETRIES;
+            const totalRetries = initialRetries ?? currentRetriesRemaining;
             if (currentRetriesRemaining > 0) {
-                const delayTime = RETRY_DELAY * (RETRIES - currentRetriesRemaining);
+                const attemptNumber = totalRetries - currentRetriesRemaining + 1;
+                const delayTime = getRetryDelay(attemptNumber);
                 await new Promise((resolve)=>setTimeout(resolve, delayTime));
                 return fetchWithRetry(url, {
                     ...options,
-                    retriesRemaining: currentRetriesRemaining - 1
+                    retriesRemaining: currentRetriesRemaining - 1,
+                    initialRetries: totalRetries
                 });
             }
         }

package/dist/config/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var name = "@quiltt/core";
-var version$1 = "5.1.2";
+var version$1 = "5.2.0";
 
 const QUILTT_API_INSECURE = (()=>{
     try {

package/dist/config/index.js

@@ -1,5 +1,5 @@
 var name = "@quiltt/core";
-var version$1 = "5.1.2";
+var version$1 = "5.2.0";
 
 const QUILTT_API_INSECURE = (()=>{
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quiltt/core",
-  "version": "5.1.2",
+  "version": "5.2.0",
   "description": "Javascript API client and utilities for Quiltt",
   "keywords": [
     "quiltt",
@@ -88,16 +88,16 @@
   ],
   "main": "dist/index.js",
   "dependencies": {
-    "@apollo/client": "^4.1.4",
+    "@apollo/client": "^4.1.6",
     "@rails/actioncable": "^8.1.200",
     "braces": "^3.0.3",
     "cross-fetch": "^4.1.0",
-    "graphql": "^16.12.0",
+    "graphql": "^16.13.0",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.0",
-    "@types/node": "24.10.13",
+    "@biomejs/biome": "2.4.5",
+    "@types/node": "24.11.0",
     "@types/rails__actioncable": "8.0.3",
     "@types/react": "19.2.14",
     "bunchee": "6.9.4",

package/src/api/browser.ts

@@ -125,7 +125,15 @@ export type ConnectorSDKCallbackMetadata = {
 export type ConnectorSDKConnectOptions = ConnectorSDKCallbacks & {
   /** The Institution ID or search term to connect */
   institution?: string
-  /** The OAuth redirect URL for mobile or embedded webview flows */
+  /**
+   * The app launcher URL for mobile OAuth flows.
+   * This URL should be a Universal Link (iOS) or App Link (Android) that redirects back to your app.
+   */
+  appLauncherUrl?: string
+  /**
+   * @deprecated Use `appLauncherUrl` instead. This property will be removed in a future version.
+   * The OAuth redirect URL for mobile or embedded webview flows.
+   */
   oauthRedirectUrl?: string
 }
 
@@ -136,7 +144,15 @@ export type ConnectorSDKConnectOptions = ConnectorSDKCallbacks & {
 export type ConnectorSDKReconnectOptions = ConnectorSDKCallbacks & {
   /** The ID of the Connection to reconnect */
   connectionId: string
-  /** The OAuth redirect URL for mobile or embedded webview flows */
+  /**
+   * The app launcher URL for mobile OAuth flows.
+   * This URL should be a Universal Link (iOS) or App Link (Android) that redirects back to your app.
+   */
+  appLauncherUrl?: string
+  /**
+   * @deprecated Use `appLauncherUrl` instead. This property will be removed in a future version.
+   * The OAuth redirect URL for mobile or embedded webview flows.
+   */
   oauthRedirectUrl?: string
 }
 
@@ -152,6 +168,14 @@ export type ConnectorSDKConnectorOptions = ConnectorSDKCallbacks & {
   connectionId?: string
   /** The nonce to use for the script tag */
   nonce?: string
-  /** The OAuth redirect URL for mobile or embedded webview flows */
+  /**
+   * The app launcher URL for mobile OAuth flows.
+   * This URL should be a Universal Link (iOS) or App Link (Android) that redirects back to your app.
+   */
+  appLauncherUrl?: string
+  /**
+   * @deprecated Use `appLauncherUrl` instead. This property will be removed in a future version.
+   * The OAuth redirect URL for mobile or embedded webview flows.
+   */
   oauthRedirectUrl?: string
 }

package/src/api/graphql/links/ActionCableLink.ts

@@ -16,7 +16,7 @@ type SubscriptionCallbacks = {
   received?: (payload: unknown) => void
 }
 
-class ActionCableLink extends ApolloLink {
+export class ActionCableLink extends ApolloLink {
   cables: { [id: string]: Consumer }
   channelName: string
   actionName: string
@@ -119,5 +119,3 @@ class ActionCableLink extends ApolloLink {
     })
   }
 }
-
-export default ActionCableLink

package/src/api/graphql/links/AuthLink.ts

@@ -37,5 +37,3 @@ export class AuthLink extends ApolloLink {
     return forward(operation)
   }
 }
-
-export default AuthLink

package/src/api/graphql/links/BatchHttpLink.ts

@@ -10,5 +10,3 @@ export const BatchHttpLink = new ApolloBatchHttpLink({
   uri: endpointGraphQL,
   fetch: effectiveFetch,
 })
-
-export default BatchHttpLink

package/src/api/graphql/links/ErrorLink.ts

@@ -38,5 +38,3 @@ export const ErrorLink = new ApolloErrorLink(({ error, result }) => {
     }
   }
 })
-
-export default ErrorLink

package/src/api/graphql/links/ForwardableLink.ts

@@ -1,5 +1,3 @@
 import { ApolloLink } from '@apollo/client/core'
 
 export const ForwardableLink = new ApolloLink((operation, forward) => forward(operation))
-
-export default ForwardableLink

package/src/api/graphql/links/HttpLink.ts

@@ -10,5 +10,3 @@ export const HttpLink = new ApolloHttpLink({
   uri: endpointGraphQL,
   fetch: effectiveFetch,
 })
-
-export default HttpLink

package/src/api/graphql/links/RetryLink.ts

@@ -9,5 +9,3 @@ export const RetryLink = new ApolloRetryLink({
     },
   },
 })
-
-export default RetryLink

package/src/api/graphql/links/SubscriptionLink.ts

@@ -1,11 +1,9 @@
 'use client'
 
-import ActionCableLink from './ActionCableLink'
+import { ActionCableLink } from './ActionCableLink'
 
 export class SubscriptionLink extends ActionCableLink {
   constructor() {
     super({ channelName: 'GraphQLChannel' })
   }
 }
-
-export default SubscriptionLink

package/src/api/graphql/links/TerminatingLink.ts

@@ -6,5 +6,3 @@ export const TerminatingLink = new ApolloLink(() => {
     observer.complete()
   })
 })
-
-export default TerminatingLink

package/src/api/rest/fetchWithRetry.ts

@@ -6,6 +6,7 @@ const effectiveFetch = typeof fetch === 'undefined' ? crossfetch : fetch
 type FetchWithRetryOptions = RequestInit & {
   retry?: boolean
   retriesRemaining?: number
+  initialRetries?: number
   validateStatus?: (status: number) => boolean
 }
 
@@ -18,7 +19,15 @@ export type FetchResponse<T> = {
 }
 
 const RETRY_DELAY = 150 // ms
-const RETRIES = 10 // 150, 300, 450, 600, 750, 900, 1050, 1200, 1350, 1500 = 8.250s
+const MAX_RETRY_DELAY = 1500 // ms
+const RETRIES = 10
+
+const getRetryDelay = (attemptNumber: number): number => {
+  const exponentialDelay = RETRY_DELAY * 2 ** (attemptNumber - 1)
+  return Math.min(exponentialDelay, MAX_RETRY_DELAY)
+}
+
+type RetryableError = Error & { retryable?: boolean }
 
 /**
  * A wrapper around the native `fetch` function that adds automatic retries on failure, including network errors and HTTP 429 responses.
@@ -31,6 +40,7 @@ export const fetchWithRetry = async <T>(
   const {
     retry,
     retriesRemaining,
+    initialRetries,
     validateStatus = (status) => status >= 200 && status < 300, // Default to success for 2xx responses
     ...fetchOptions
   } = options
@@ -52,19 +62,29 @@ export const fetchWithRetry = async <T>(
 
     // If validateStatus fails, and retry is enabled, prepare to retry for eligible status codes
     if (retry && (response.status >= 500 || response.status === 429)) {
-      throw new Error('Retryable failure')
+      const error = new Error(`HTTP error with status ${response.status}`) as RetryableError
+      error.retryable = true
+      throw error
     }
 
-    throw new Error(`HTTP error with status ${response.status}`)
+    const error = new Error(`HTTP error with status ${response.status}`) as RetryableError
+    error.retryable = false
+    throw error
   } catch (error) {
-    if (retry) {
+    const retryableError = error as RetryableError
+    const shouldRetry = retry && retryableError.retryable !== false
+
+    if (shouldRetry) {
       const currentRetriesRemaining = retriesRemaining !== undefined ? retriesRemaining : RETRIES
+      const totalRetries = initialRetries ?? currentRetriesRemaining
       if (currentRetriesRemaining > 0) {
-        const delayTime = RETRY_DELAY * (RETRIES - currentRetriesRemaining)
+        const attemptNumber = totalRetries - currentRetriesRemaining + 1
+        const delayTime = getRetryDelay(attemptNumber)
         await new Promise((resolve) => setTimeout(resolve, delayTime))
         return fetchWithRetry(url, {
           ...options,
           retriesRemaining: currentRetriesRemaining - 1,
+          initialRetries: totalRetries,
         })
       }
     }

package/src/observables/observable.ts

@@ -38,5 +38,3 @@ export class Observable<T> {
     this.observers = this.observers.filter((update) => update !== observer)
   }
 }
-
-export default Observable

package/src/timing/timeoutable.ts

@@ -29,5 +29,3 @@ export class Timeoutable {
     this.observers[0](undefined)
   }
 }
-
-export default Timeoutable