despia-native 1.0.24 → 1.0.25

package/README.md

@@ -3,7 +3,7 @@
 JavaScript SDK for [Despia](https://despia.com). Build with any web framework, access 50+ native device capabilities through a single JavaScript function, and publish to iOS and Android from a browser. No Swift, no Kotlin, no terminal.
 
 [![npm](https://img.shields.io/npm/v/despia-native)](https://www.npmjs.com/package/despia-native)
-[![license](https://img.shields.io/npm/l/despia-native)](LICENSE)
+[![license](https://img.shields.io/npm/l/despia-native)](https://github.com/despia-native/despia-native/blob/main/LICENSE)
 
 **[Documentation](https://setup.despia.com)** | **[AI Agent Index](https://setup.despia.com/llms.txt)** | **[iOS Deployment](https://setup.despia.com/deployment/apple-ios/automatic)** | **[Android Deployment](https://setup.despia.com/deployment/google-android/automatic)**
 
@@ -17,8 +17,12 @@ The runtime runs on WKWebView (iOS) and the Chromium-based WebView (Android) wit
 
 Add the Despia MCP to give your AI assistant full knowledge of the `despia-native` API.
 
-[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=Despia&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vc2V0dXAuZGVzcGlhLmNvbS9tY3AifQ==)
-[![Install in VS Code](https://img.shields.io/badge/Install_in_VS_Code-007ACC?logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22Despia%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fsetup.despia.com%2Fmcp%22%7D)
+<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=Despia&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vc2V0dXAuZGVzcGlhLmNvbS9tY3AifQ==">
+  <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor" />
+</a>
+<a href="vscode:mcp/install?%7B%22name%22%3A%22Despia%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fsetup.despia.com%2Fmcp%22%7D">
+  <img src="https://img.shields.io/badge/Install_in_VS_Code-007ACC?logo=visualstudiocode&logoColor=white" alt="Install in VS Code" />
+</a>
 
 ```
 https://setup.despia.com/mcp
@@ -225,6 +229,8 @@ despia('warninghaptic://'); // Attention alert
 despia('errorhaptic://');   // Negative feedback
 ```
 
+[Read Full Documentation](https://setup.despia.com/native-features/haptic-feedback)
+
 ---
 
 ### Identity Vault
@@ -292,6 +298,8 @@ async function checkTrialEligibility() {
 }
 ```
 
+[Read Full Documentation](https://setup.despia.com/native-features/storage-vault) + [Read Full Documentation](https://setup.despia.com/native-features/biometrics)
+
 ---
 
 ### GPS Location
@@ -320,7 +328,7 @@ despia('location://?server=https://api.example.com/track?user=USER_ID&buffer=30&
 
 Each POST body matches the location object shape returned by `stoplocation://`.
 
-Full docs: [https://setup.despia.com/native-features/gps-location](https://setup.despia.com/native-features/gps-location)
+[Read Full Documentation](https://setup.despia.com/native-features/gps-location)
 
 ---
 
@@ -390,7 +398,7 @@ if (isDespia) {
 }
 ```
 
-Full RevenueCat docs: [https://setup.despia.com/native-features/revenuecat/reference](https://setup.despia.com/native-features/revenuecat/reference)
+[Read Full Documentation](https://setup.despia.com/native-features/revenuecat/introduction) + [API reference](https://setup.despia.com/native-features/revenuecat/reference)
 
 ---
 
@@ -446,7 +454,7 @@ despia('appsflyer://log_event?event_name=onboarding_step&event_values=' + encode
 
 `event_values` must always be `JSON.stringify()`ed and `encodeURIComponent()`ed. Event names are case-sensitive, lowercase alphanumeric and underscores only, max 300 unique names per day.
 
-Full attribution docs: [https://setup.despia.com/analytics/appsflyer/introduction](https://setup.despia.com/analytics/appsflyer/introduction)
+[Read Full Documentation](https://setup.despia.com/analytics/appsflyer/introduction) + [Read Full Documentation](https://setup.despia.com/analytics/appsflyer/attribution)
 
 ---
 
@@ -488,7 +496,7 @@ await fetch('https://onesignal.com/api/v1/notifications', {
 });
 ```
 
-When configuring OneSignal, select **Native iOS** and **Native Android** as the platforms. For critical alerts that bypass Do Not Disturb, see the full push docs: [https://setup.despia.com](https://setup.despia.com)
+When configuring OneSignal, select **Native iOS** and **Native Android** as the platforms. See [Read Full Documentation](https://setup.despia.com/native-features/onesignal/introduction) + [API reference](https://setup.despia.com/native-features/onesignal/reference) for setup, critical alerts (including Time Sensitive / Do Not Disturb), schemes, backend delivery, and targeting.
 
 ---
 
@@ -565,7 +573,7 @@ When Despia navigates the WebView to `/auth`, if that route is already active yo
 - Vue: use `watch: { '$route.query': { immediate: true, handler } }` instead of reading params in `mounted()`
 - Vanilla JS: call your handler on load and add `window.addEventListener('popstate', handler)`
 
-Full docs: [https://setup.despia.com/native-features/o-auth-2-0](https://setup.despia.com/native-features/o-auth-2-0)
+[Read Full Documentation](https://setup.despia.com/native-features/oauth/introduction)
 
 ---
 
@@ -575,6 +583,8 @@ Full docs: [https://setup.despia.com/native-features/o-auth-2-0](https://setup.d
 const { clipboarddata } = await despia('getclipboard://', ['clipboarddata']);
 ```
 
+[Read Full Documentation](https://setup.despia.com/native-features/clipboard)
+
 ---
 
 ### Contacts
@@ -583,6 +593,8 @@ const { clipboarddata } = await despia('getclipboard://', ['clipboarddata']);
 const { contacts } = await despia('readcontacts://', ['contacts']);
 ```
 
+[Read Full Documentation](https://setup.despia.com/native-features/contact-access)
+
 ---
 
 ### App Information and Device Data
@@ -594,6 +606,8 @@ const { storeLocation }    = await despia('getstorelocation://',      ['storeLoc
 const { trackingDisabled } = await despia('user-disable-tracking://', ['trackingDisabled']);
 ```
 
+[Read Full Documentation](https://setup.despia.com/native-features/device-indexing) + [Read Full Documentation](https://setup.despia.com/native-features/store-location) + [Read Full Documentation](https://setup.despia.com/native-features/app-privacy)
+
 ---
 
 ### UI Controls and Styling
@@ -609,6 +623,8 @@ despia('settingsapp://');                   // Open native app settings
 despia('reset://');                         // Reset the app
 ```
 
+[Read Full Documentation](https://setup.despia.com/native-features/safe-areas) + [Read Full Documentation](https://setup.despia.com/native-features/app-settings)
+
 ---
 
 ### File and Media Operations
@@ -639,6 +655,8 @@ despia('shareapp://message?=Check%20out%20this%20app&url=https://myapp.com');
 despia('scanningmode://auto'); // auto | on | off
 ```
 
+[Read Full Documentation](https://setup.despia.com/native-features/file-sharing) + [Read Full Documentation](https://setup.despia.com/native-features/camera-roll)
+
 ---
 
 ### Apple Health (HealthKit)
@@ -658,7 +676,7 @@ despia('writehealthkit://HKQuantityTypeIdentifierBodyMass//74.5');
 despia('healthkit://observe?types=HKQuantityTypeIdentifierStepCount&frequency=hourly&server=https://api.example.com/webhook?user=USER_ID');
 ```
 
-Pass any valid `HKQuantityTypeIdentifier`, `HKCategoryTypeIdentifier`, `HKWorkoutTypeIdentifier`, or `HKCharacteristicTypeIdentifier` directly. Sleep, workouts, heart rate, body mass, and all other HealthKit types are supported. Full docs: [https://setup.despia.com](https://setup.despia.com)
+Pass any valid `HKQuantityTypeIdentifier`, `HKCategoryTypeIdentifier`, `HKWorkoutTypeIdentifier`, or `HKCharacteristicTypeIdentifier` directly. Sleep, workouts, heart rate, body mass, and all other HealthKit types are supported. [Read Full Documentation](https://setup.despia.com/health-data/apple-health).
 
 ---
 
@@ -683,7 +701,7 @@ Once enabled, serve ads using standard AdSense, Google Publisher Tag, or IMA for
 
 Because ads are real DOM elements, placements that are impossible with native overlay ads — banners between feed cards, mid-article units, rewarded content gates, pre-roll video — are straightforward CSS and JavaScript.
 
-Google WebView API for Ads references: [iOS](https://developers.google.com/admob/ios/browser/webview/api-for-ads) | [Android](https://developers.google.com/admob/android/browser/webview/api-for-ads) | Full Despia docs: [https://setup.despia.com](https://setup.despia.com)
+Google WebView API for Ads references: [iOS](https://developers.google.com/admob/ios/browser/webview/api-for-ads) | [Android](https://developers.google.com/admob/android/browser/webview/api-for-ads) | [Read Full Documentation](https://setup.despia.com/native-features/admob/inline-ads) + [Read Full Documentation](https://setup.despia.com/native-features/admob/rewarded-ads)
 
 ---
 
@@ -704,7 +722,7 @@ const result = await request.show();
 await result.complete('success');
 ```
 
-Apple Pay on iOS and Google Pay on Android both work via the standard Web Payment Request API. No Despia-specific calls required. Reference: [Google Pay in Android WebView](https://developers.google.com/pay/api/android/guides/recipes/using-android-webview)
+Apple Pay on iOS and Google Pay on Android both work via the standard Web Payment Request API. No Despia-specific calls required. [Read Full Documentation](https://setup.despia.com/native-features/external-links) + [Google Pay in Android WebView](https://developers.google.com/pay/api/android/guides/recipes/using-android-webview)
 
 ---
 
@@ -730,6 +748,8 @@ const key = await crypto.subtle.generateKey(
 
 For data that needs to survive uninstall and reinstall, or be locked behind Face ID, use [Identity Vault](#identity-vault) instead.
 
+[Read Full Documentation](https://setup.despia.com/local-server/introduction) + [Read Full Documentation](https://setup.despia.com/native-features/simple-storage)
+
 ---
 
 ### Local Server
@@ -781,7 +801,7 @@ The plugin generates `despia/local.json` in your output directory alongside your
 }
 ```
 
-Full docs: [https://setup.despia.com/local-server/introduction](https://setup.despia.com/local-server/introduction)
+[Read Full Documentation](https://setup.despia.com/local-server/introduction) + [API reference](https://setup.despia.com/local-server/reference)
 
 ---
 
@@ -845,7 +865,7 @@ const data = await res.json();
 | `/api/upload`      | `/files/`    | `localhost:{PORT}/files/{filename}`    |
 
 
-Full docs: [https://setup.despia.com/local-cdn/introduction](https://setup.despia.com/local-cdn/introduction)
+[Read Full Documentation](https://setup.despia.com/local-cdn/introduction) + [API reference](https://setup.despia.com/local-cdn/reference)
 
 ---
 
@@ -883,6 +903,8 @@ Despia exposes top and bottom safe area insets as CSS custom properties set by t
 
 Note: left and right safe area variables are not available.
 
+[Read Full Documentation](https://setup.despia.com/native-features/safe-areas)
+
 ---
 
 ## Extending the Runtime
@@ -951,7 +973,7 @@ It is not for React Native, Expo, or native mobile development.
 
 Despia provides fully automated iOS and Android store deployment from the web editor. No Mac required. One-click deployment spins up Mac Mini build infrastructure in the cloud, handles code signing, provisioning, and submits to both the App Store and Google Play — entirely from a browser.
 
-Full deployment docs: [https://setup.despia.com/deployment/apple-ios/automatic](https://setup.despia.com/deployment/apple-ios/automatic)
+[Read Full Documentation](https://setup.despia.com/deployment/apple-ios/automatic) + [Read Full Documentation](https://setup.despia.com/deployment/google-android/automatic)
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "despia-native",
-    "version": "1.0.24",
+    "version": "1.0.25",
     "description": "Web-native iOS and Android SDK. Biometrics, GPS, in-app purchases, push notifications, and 50+ native APIs - no Swift, no Kotlin.",
     "main": "index.js",
     "module": "index.js",