@quiltt/capacitor 5.1.2

package/LICENSE.md

@@ -0,0 +1,9 @@
+# MIT License
+
+Copyright (c) Quiltt, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/QuilttConnector.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'QuilttConnector'
+  s.version = package['version']
+  s.summary = 'Quiltt Connector Capacitor Plugin'
+  s.license = package['license']
+  s.homepage = package['repository']['url'].gsub(/^git\+/, '').gsub(/\.git$/, '')
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'].gsub(/^git\+/, ''), :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '14.0'
+  s.dependency 'Capacitor'
+  s.swift_version = '5.1'
+end

package/README.md

@@ -0,0 +1,214 @@
+# @quiltt/capacitor
+
+[![npm version](https://badge.fury.io/js/@quiltt%2Fcapacitor.svg)](https://badge.fury.io/js/@quiltt%2Fcapacitor)
+[![CI](https://github.com/quiltt/quiltt-js/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/quiltt/quiltt-js/actions/workflows/ci.yml)
+
+Quiltt Connector SDK for Capacitor and Ionic apps on iOS, Android, and web.
+
+| Import                    | Use Case                                         |
+| ------------------------- | ------------------------------------------------ |
+| `@quiltt/capacitor`       | Any framework (Vue, Angular, Svelte, vanilla JS) |
+| `@quiltt/capacitor/vue`   | Vue 3 components and composables                 |
+| `@quiltt/capacitor/react` | React components and hooks                       |
+
+## Installation
+
+```shell
+npm install @quiltt/capacitor
+npx cap sync
+```
+
+## Deep Link Configuration
+
+Configure URL schemes for OAuth callbacks from bank authentication.
+
+**iOS** — `ios/App/Info.plist`:
+
+```xml
+<key>CFBundleURLTypes</key>
+<array>
+  <dict>
+    <key>CFBundleURLSchemes</key>
+    <array>
+      <string>myapp</string>
+    </array>
+  </dict>
+</array>
+```
+
+**Android** — `android/app/src/main/AndroidManifest.xml`:
+
+```xml
+<intent-filter>
+  <action android:name="android.intent.action.VIEW" />
+  <category android:name="android.intent.category.DEFAULT" />
+  <category android:name="android.intent.category.BROWSABLE" />
+  <data android:scheme="myapp" />
+</intent-filter>
+```
+
+## Vue 3
+
+```shell
+npm install @quiltt/capacitor @quiltt/vue vue
+```
+
+```typescript
+// main.ts
+import { createApp } from 'vue'
+import { QuilttPlugin } from '@quiltt/capacitor/vue'
+
+createApp(App).use(QuilttPlugin).mount('#app')
+```
+
+```vue
+<script setup lang="ts">
+import { QuilttConnector, QuilttConnectorPlugin } from '@quiltt/capacitor/vue'
+import { onMounted, onUnmounted, ref } from 'vue'
+
+const connectorRef = ref()
+
+onMounted(() => {
+  QuilttConnectorPlugin.addListener('deepLink', ({ url }) => {
+    connectorRef.value?.handleOAuthCallback(url)
+  })
+})
+onUnmounted(() => QuilttConnectorPlugin.removeAllListeners())
+</script>
+
+<template>
+  <QuilttConnector
+    ref="connectorRef"
+    connector-id="YOUR_CONNECTOR_ID"
+    app-launcher-url="https://app.example.com/quiltt/callback"
+    @exit-success="(m) => console.log('Connected:', m.connectionId)"
+    @navigate="(url) => QuilttConnectorPlugin.openUrl({ url })"
+    style="width: 100%; height: 100vh"
+  />
+</template>
+```
+
+For modal-based connection:
+
+```vue
+<QuilttButton connector-id="YOUR_CONNECTOR_ID" @exit-success="handleSuccess">
+  Add Bank Account
+</QuilttButton>
+```
+
+## React
+
+```shell
+npm install @quiltt/capacitor @quiltt/react react react-dom
+```
+
+```tsx
+import { QuilttProvider, QuilttConnector } from '@quiltt/capacitor/react'
+
+export const App = () => (
+  <QuilttProvider token="YOUR_SESSION_TOKEN">
+    <QuilttConnector
+      connectorId="YOUR_CONNECTOR_ID"
+      appLauncherUrl="https://app.example.com/quiltt/callback"
+      onExitSuccess={(m) => console.log('Connected:', m.connectionId)}
+      style={{ flex: 1 }}
+    />
+  </QuilttProvider>
+)
+```
+
+OAuth is handled automatically—bank auth opens in the system browser and deep link callbacks are captured on return.
+
+For modal-based connection:
+
+```tsx
+<QuilttButton connectorId="YOUR_CONNECTOR_ID" onExitSuccess={handleSuccess}>
+  Add Account
+</QuilttButton>
+```
+
+## Other Frameworks
+
+Use the native plugin directly with Angular, Svelte, or vanilla JS:
+
+```typescript
+import { QuilttConnector } from '@quiltt/capacitor'
+
+// Open OAuth URL in system browser
+await QuilttConnector.openUrl({ url: 'https://...' })
+
+// Listen for deep link callbacks
+await QuilttConnector.addListener('deepLink', ({ url }) => {
+  console.log('OAuth callback:', url)
+})
+```
+
+## Reconnection
+
+Pass a `connectionId` / `connection-id` to reconnect an existing connection:
+
+```tsx
+<QuilttConnector connectionId="YOUR_EXISTING_CONNECTION_ID" ... />
+```
+
+## API Reference
+
+### Native Plugin
+
+```typescript
+import { QuilttConnector } from '@quiltt/capacitor'
+```
+
+| Method                              | Description                           |
+| ----------------------------------- | ------------------------------------- |
+| `openUrl({ url })`                  | Opens URL in system browser           |
+| `getLaunchUrl()`                    | Returns the URL that launched the app |
+| `addListener('deepLink', callback)` | Listens for deep link callbacks       |
+| `removeAllListeners()`              | Removes all event listeners           |
+
+### Component Props
+
+| Prop             | Type                 | Description                             |
+| ---------------- | -------------------- | --------------------------------------- |
+| `connectorId`    | `string`             | **Required.** Quiltt Connector ID       |
+| `connectionId`   | `string`             | Existing connection ID for reconnection |
+| `institution`    | `string`             | Pre-select an institution               |
+| `appLauncherUrl` | `string`             | Deep link URL for OAuth callbacks       |
+| `onLoad`         | `(metadata) => void` | Connector loaded                        |
+| `onExitSuccess`  | `(metadata) => void` | Connection successful                   |
+| `onExitAbort`    | `(metadata) => void` | User cancelled                          |
+| `onExitError`    | `(metadata) => void` | Error occurred                          |
+
+### Re-exports
+
+`@quiltt/capacitor/react` re-exports everything from `@quiltt/react`:
+
+- Components: `QuilttProvider`, `QuilttButton`, `QuilttContainer`
+- Hooks: `useQuilttSession`, `useQuilttConnector`, `useQuilttClient`
+- Apollo Client: `useQuery`, `useMutation`, `gql`
+
+`@quiltt/capacitor/vue` re-exports everything from `@quiltt/vue`.
+
+## Troubleshooting
+
+### OAuth redirects not working
+
+- Verify `appLauncherUrl` matches your URL scheme
+- Run `npx cap sync` after configuration changes
+
+### Blank screen after bank auth
+
+- Check browser console for errors
+- Verify your Connector ID
+
+## Resources
+
+- [Capacitor SDK Guide](https://www.quiltt.dev/connector/sdk/capacitor)
+- [Issuing Session Tokens](https://www.quiltt.dev/authentication/issuing-session-tokens)
+- [Connector Configuration](https://www.quiltt.dev/connector)
+- [Capacitor React Example](../../examples/capacitor-react/README.md)
+- [Capacitor Vue Example](../../examples/capacitor-vue/README.md)
+
+## License
+
+MIT

package/android/build.gradle

@@ -0,0 +1,59 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.6.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.1.5'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.5.1'
+}
+
+buildscript {
+    ext.kotlin_version = project.hasProperty('kotlinVersion') ? rootProject.ext.kotlinVersion : '1.9.22'
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.2.1'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    namespace "app.quiltt.capacitor"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 34
+    defaultConfig {
+        minSdk project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 22
+        targetSdk project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 34
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/proguard-rules.pro

@@ -0,0 +1,11 @@
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in /usr/local/Cellar/android-sdk/24.3.3/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the proguardFiles
+# directive in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Keep Quiltt Connector plugin classes
+-keep class app.quiltt.capacitor.** { *; }

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/kotlin/app/quiltt/capacitor/QuilttConnectorPlugin.kt

@@ -0,0 +1,83 @@
+package app.quiltt.capacitor
+
+import android.content.Intent
+import android.net.Uri
+import com.getcapacitor.JSObject
+import com.getcapacitor.Plugin
+import com.getcapacitor.PluginCall
+import com.getcapacitor.PluginMethod
+import com.getcapacitor.annotation.CapacitorPlugin
+
+/**
+ * QuilttConnector Capacitor Plugin for Android
+ * Handles deep linking, URL opening, and OAuth redirect flows for Quiltt Connector integration
+ */
+@CapacitorPlugin(name = "QuilttConnector")
+class QuilttConnectorPlugin : Plugin() {
+    private var launchUrl: String? = null
+
+    override fun load() {
+        // Check if the app was launched via an intent with a URL
+        val intent = activity?.intent
+        handleIntent(intent)
+    }
+
+    override fun handleOnNewIntent(intent: Intent) {
+        super.handleOnNewIntent(intent)
+        handleIntent(intent)
+    }
+
+    private fun handleIntent(intent: Intent?) {
+        val data = intent?.data
+        if (data != null) {
+            val url = data.toString()
+            launchUrl = url
+
+            // Notify JavaScript listeners
+            val ret = JSObject()
+            ret.put("url", url)
+            notifyListeners("deepLink", ret)
+        }
+    }
+
+    /**
+     * Opens a URL in the system browser
+     * Used for OAuth flows and external authentication
+     */
+    @PluginMethod
+    fun openUrl(call: PluginCall) {
+        val urlString = call.getString("url")
+        if (urlString.isNullOrEmpty()) {
+            call.reject("Invalid URL")
+            return
+        }
+
+        try {
+            val uri = Uri.parse(urlString)
+            val intent = Intent(Intent.ACTION_VIEW, uri)
+            intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK
+            context.startActivity(intent)
+
+            val ret = JSObject()
+            ret.put("completed", true)
+            call.resolve(ret)
+        } catch (e: Exception) {
+            call.reject("Failed to open URL: ${e.message}")
+        }
+    }
+
+    /**
+     * Returns the URL that launched the app (if any)
+     * Used to handle OAuth callbacks and deep link navigation
+     */
+    @PluginMethod
+    fun getLaunchUrl(call: PluginCall) {
+        val ret = JSObject()
+        if (launchUrl != null) {
+            ret.put("url", launchUrl)
+        } else {
+            ret.put("url", JSObject.NULL)
+        }
+        call.resolve(ret)
+    }
+}

package/dist/index.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var core = require('@capacitor/core');
+
+/**
+ * Native Capacitor plugin for deep link handling and URL opening
+ * Used internally by QuilttConnector component for OAuth flows
+ */ const QuilttConnector = core.registerPlugin('QuilttConnector', {
+    web: ()=>Promise.resolve().then(function () { return require('./web-BgcuNl8a.cjs'); }).then((m)=>new m.QuilttConnectorWeb())
+});
+
+exports.QuilttConnector = QuilttConnector;

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+import { PluginListenerHandle } from '@capacitor/core';
+
+/**
+ * Options for opening a URL in the system browser
+ */
+interface OpenUrlOptions {
+    /**
+     * The URL to open in the system browser
+     */
+    url: string;
+}
+/**
+ * Event data when a deep link is received
+ */
+interface DeepLinkEvent {
+    /**
+     * The full URL that was used to open the app, or null if no URL was present
+     */
+    url: string | null;
+}
+/**
+ * Listener function for deep link events
+ */
+type DeepLinkListener = (event: DeepLinkEvent) => void;
+/**
+ * The Quiltt Connector Capacitor plugin interface.
+ *
+ * This plugin handles native functionality required for the Quiltt Connector:
+ * - Opening OAuth URLs in the system browser
+ * - Handling deep links / App Links / Universal Links for OAuth callbacks
+ */
+interface QuilttConnectorPlugin {
+    /**
+     * Open a URL in the system browser.
+     *
+     * This is used for OAuth flows where the user needs to authenticate
+     * with their financial institution in an external browser.
+     *
+     * @param options - The options containing the URL to open
+     * @returns A promise that resolves when the browser is opened
+     *
+     * @since 5.0.3
+     */
+    openUrl(options: OpenUrlOptions): Promise<{
+        completed: boolean;
+    }>;
+    /**
+     * Get the URL that was used to launch the app, if any.
+     *
+     * This is useful for handling OAuth callbacks when the app is opened
+     * from a Universal Link (iOS) or App Link (Android).
+     *
+     * @returns A promise that resolves with the launch URL, or undefined if none
+     *
+     * @since 5.0.3
+     */
+    getLaunchUrl(): Promise<DeepLinkEvent>;
+    /**
+     * Listen for deep link events.
+     *
+     * This is called when the app is opened via a Universal Link (iOS)
+     * or App Link (Android), typically during OAuth callback flows.
+     *
+     * @param eventName - The event name ('deepLink')
+     * @param listenerFunc - The callback function to handle the event
+     * @returns A promise that resolves with a handle to remove the listener
+     *
+     * @since 5.0.3
+     */
+    addListener(eventName: 'deepLink', listenerFunc: DeepLinkListener): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners for this plugin.
+     *
+     * @since 5.0.3
+     */
+    removeAllListeners(): Promise<void>;
+}
+
+/**
+ * Native Capacitor plugin for deep link handling and URL opening
+ * Used internally by QuilttConnector component for OAuth flows
+ */
+declare const QuilttConnector: QuilttConnectorPlugin;
+
+export { QuilttConnector };
+export type { DeepLinkEvent, DeepLinkListener, OpenUrlOptions, QuilttConnectorPlugin };

package/dist/index.js

@@ -0,0 +1,10 @@
+import { registerPlugin } from '@capacitor/core';
+
+/**
+ * Native Capacitor plugin for deep link handling and URL opening
+ * Used internally by QuilttConnector component for OAuth flows
+ */ const QuilttConnector = registerPlugin('QuilttConnector', {
+    web: ()=>import('./web-CUWsqcUV.js').then((m)=>new m.QuilttConnectorWeb())
+});
+
+export { QuilttConnector };