@capgo/capacitor-launch-navigator 7.0.0

package/CapgoCapacitorLaunchNavigator.podspec

@@ -0,0 +1,17 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapgoCapacitorLaunchNavigator'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :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/Package.swift

@@ -0,0 +1,28 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapgoCapacitorLaunchNavigator",
+    platforms: [.iOS(.v14)],
+    products: [
+        .library(
+            name: "CapgoCapacitorLaunchNavigator",
+            targets: ["LaunchNavigatorPlugin"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "7.0.0")
+    ],
+    targets: [
+        .target(
+            name: "LaunchNavigatorPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm")
+            ],
+            path: "ios/Sources/LaunchNavigatorPlugin"),
+        .testTarget(
+            name: "LaunchNavigatorPluginTests",
+            dependencies: ["LaunchNavigatorPlugin"],
+            path: "ios/Tests/LaunchNavigatorPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,316 @@
+# @capgo/capacitor-launch-navigator
+ <a href="https://capgo.app/"><img src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/></a>
+
+<div align="center">
+  <h2><a href="https://capgo.app/?ref=plugin"> ➡️ Get Instant updates for your App with Capgo</a></h2>
+  <h2><a href="https://capgo.app/consulting/?ref=plugin"> Missing a feature? We’ll build the plugin for you 💪</a></h2>
+</div>
+
+Capacitor plugin for launching navigation apps to navigate to a destination.
+
+This plugin is a Capacitor port of the popular phonegap-launch-navigator plugin, supporting navigation with latitude/longitude coordinates only (no address support - use [@capgo/capacitor-nativegeocoder](https://github.com/Cap-go/capacitor-nativegeocoder) for address geocoding).
+
+## Install
+
+```bash
+npm install @capgo/capacitor-launch-navigator
+npx cap sync
+```
+
+## iOS Setup
+
+Add URL schemes to your `Info.plist` to detect installed navigation apps:
+
+```xml
+<key>LSApplicationQueriesSchemes</key>
+<array>
+    <string>comgooglemaps</string>
+    <string>waze</string>
+    <string>citymapper</string>
+    <string>navigon</string>
+    <string>transit</string>
+    <string>yandexnavi</string>
+    <string>uber</string>
+    <string>tomtomgo</string>
+    <string>com.sygic.aura</string>
+    <string>here-route</string>
+    <string>moovit</string>
+    <string>lyft</string>
+    <string>mapsme</string>
+    <string>cabify</string>
+    <string>baidumap</string>
+    <string>iosamap</string>
+    <string>99app</string>
+</array>
+```
+
+## Usage
+
+```typescript
+import { LaunchNavigator, IOSNavigationApp, AndroidNavigationApp, TransportMode } from '@capgo/capacitor-launch-navigator';
+
+// Navigate to a location using default app
+await LaunchNavigator.navigate({
+    destination: [37.7749, -122.4194] // San Francisco coordinates
+});
+
+// Navigate with options
+await LaunchNavigator.navigate({
+    destination: [37.7749, -122.4194],
+    options: {
+        start: [37.7849, -122.4094], // Starting point
+        app: 'google_maps', // Specific app to use
+        transportMode: TransportMode.DRIVING
+    }
+});
+
+// Check if an app is available
+const { available } = await LaunchNavigator.isAppAvailable({
+    app: IOSNavigationApp.GOOGLE_MAPS
+});
+
+// Get list of available navigation apps
+const { apps } = await LaunchNavigator.getAvailableApps();
+apps.forEach(app => {
+    console.log(`${app.name} is ${app.available ? 'available' : 'not installed'}`);
+});
+```
+
+## Important Notes
+
+- **Coordinates Only**: This plugin only accepts latitude/longitude coordinates for navigation. Address strings are not supported.
+- **Address Geocoding**: If you need to convert addresses to coordinates, use [@capgo/capacitor-nativegeocoder](https://github.com/Cap-go/capacitor-nativegeocoder).
+
+## Supported Navigation Apps
+
+### iOS
+- Apple Maps
+- Google Maps
+- Waze
+- Citymapper
+- Garmin Navigon
+- Transit App
+- Yandex Navigator
+- Uber
+- TomTom
+- Sygic
+- HERE Maps
+- Moovit
+- Lyft
+- MAPS.ME
+- Cabify
+- Baidu Maps
+- Gaode Maps
+- 99 Taxi
+
+### Android
+- Google Maps
+- Waze
+- Citymapper
+- Uber
+- Yandex Navigator
+- Sygic
+- HERE Maps
+- Moovit
+- Lyft
+- MAPS.ME
+- Cabify
+- Baidu Maps
+- Gaode Maps
+
+## API
+
+<docgen-index>
+
+* [`navigate(...)`](#navigate)
+* [`isAppAvailable(...)`](#isappavailable)
+* [`getAvailableApps()`](#getavailableapps)
+* [`getSupportedApps()`](#getsupportedapps)
+* [`getDefaultApp()`](#getdefaultapp)
+* [Interfaces](#interfaces)
+* [Type Aliases](#type-aliases)
+* [Enums](#enums)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+Main plugin interface
+
+### navigate(...)
+
+```typescript
+navigate(options: { destination: [number, number]; options?: NavigateOptions; }) => Promise<void>
+```
+
+Navigate to a location using latitude and longitude
+
+| Param         | Type                                                                                                      | Description                                     |
+| ------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| **`options`** | <code>{ destination: [number, number]; options?: <a href="#navigateoptions">NavigateOptions</a>; }</code> | Navigation options with destination coordinates |
+
+--------------------
+
+
+### isAppAvailable(...)
+
+```typescript
+isAppAvailable(options: { app: IOSNavigationApp | AndroidNavigationApp | string; }) => Promise<{ available: boolean; }>
+```
+
+Check if a specific navigation app is available
+
+| Param         | Type                          | Description                       |
+| ------------- | ----------------------------- | --------------------------------- |
+| **`options`** | <code>{ app: string; }</code> | Options containing app identifier |
+
+**Returns:** <code>Promise&lt;{ available: boolean; }&gt;</code>
+
+--------------------
+
+
+### getAvailableApps()
+
+```typescript
+getAvailableApps() => Promise<{ apps: AvailableApp[]; }>
+```
+
+Get list of available navigation apps on the device
+
+**Returns:** <code>Promise&lt;{ apps: AvailableApp[]; }&gt;</code>
+
+--------------------
+
+
+### getSupportedApps()
+
+```typescript
+getSupportedApps() => Promise<{ apps: string[]; }>
+```
+
+Get list of supported apps for the current platform
+
+**Returns:** <code>Promise&lt;{ apps: string[]; }&gt;</code>
+
+--------------------
+
+
+### getDefaultApp()
+
+```typescript
+getDefaultApp() => Promise<{ app: string; }>
+```
+
+Get the name of the default app for navigation
+
+**Returns:** <code>Promise&lt;{ app: string; }&gt;</code>
+
+--------------------
+
+
+### Interfaces
+
+
+#### NavigateOptions
+
+Options for navigation
+
+| Prop                  | Type                                                         | Description                                                           |
+| --------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------- |
+| **`start`**           | <code>[number, number]</code>                                | Starting location coordinates [latitude, longitude]                   |
+| **`startName`**       | <code>string</code>                                          | Starting location name                                                |
+| **`destinationName`** | <code>string</code>                                          | Destination name (will be ignored since we only support coordinates)  |
+| **`transportMode`**   | <code><a href="#transportmode">TransportMode</a></code>      | Transport mode                                                        |
+| **`app`**             | <code>string</code>                                          | Specific app to launch (if not specified, will use default or prompt) |
+| **`launchMode`**      | <code><a href="#launchmode">LaunchMode</a></code>            | Launch mode                                                           |
+| **`extras`**          | <code><a href="#record">Record</a>&lt;string, any&gt;</code> | Additional parameters specific to certain apps                        |
+| **`enableDebug`**     | <code>boolean</code>                                         | Enable debug logging                                                  |
+
+
+#### AvailableApp
+
+Result of checking app availability
+
+| Prop            | Type                 | Description                                |
+| --------------- | -------------------- | ------------------------------------------ |
+| **`app`**       | <code>string</code>  | App identifier                             |
+| **`name`**      | <code>string</code>  | Display name of the app                    |
+| **`available`** | <code>boolean</code> | Whether the app is available on the device |
+
+
+### Type Aliases
+
+
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+
+### Enums
+
+
+#### TransportMode
+
+| Members         | Value                    |
+| --------------- | ------------------------ |
+| **`DRIVING`**   | <code>'driving'</code>   |
+| **`WALKING`**   | <code>'walking'</code>   |
+| **`BICYCLING`** | <code>'bicycling'</code> |
+| **`TRANSIT`**   | <code>'transit'</code>   |
+
+
+#### IOSNavigationApp
+
+| Members                | Value                         |
+| ---------------------- | ----------------------------- |
+| **`APPLE_MAPS`**       | <code>'apple_maps'</code>     |
+| **`GOOGLE_MAPS`**      | <code>'google_maps'</code>    |
+| **`WAZE`**             | <code>'waze'</code>           |
+| **`CITYMAPPER`**       | <code>'citymapper'</code>     |
+| **`GARMIN_NAVIGON`**   | <code>'garmin_navigon'</code> |
+| **`TRANSIT_APP`**      | <code>'transit_app'</code>    |
+| **`YANDEX_NAVIGATOR`** | <code>'yandex'</code>         |
+| **`UBER`**             | <code>'uber'</code>           |
+| **`TOMTOM`**           | <code>'tomtom'</code>         |
+| **`SYGIC`**            | <code>'sygic'</code>          |
+| **`HERE_MAPS`**        | <code>'here'</code>           |
+| **`MOOVIT`**           | <code>'moovit'</code>         |
+| **`LYFT`**             | <code>'lyft'</code>           |
+| **`MAPS_ME`**          | <code>'mapsme'</code>         |
+| **`CABIFY`**           | <code>'cabify'</code>         |
+| **`BAIDU`**            | <code>'baidu'</code>          |
+| **`GAODE`**            | <code>'gaode'</code>          |
+| **`TAXI_99`**          | <code>'99taxi'</code>         |
+
+
+#### AndroidNavigationApp
+
+| Members           | Value                      |
+| ----------------- | -------------------------- |
+| **`GOOGLE_MAPS`** | <code>'google_maps'</code> |
+| **`WAZE`**        | <code>'waze'</code>        |
+| **`CITYMAPPER`**  | <code>'citymapper'</code>  |
+| **`UBER`**        | <code>'uber'</code>        |
+| **`YANDEX`**      | <code>'yandex'</code>      |
+| **`SYGIC`**       | <code>'sygic'</code>       |
+| **`HERE_MAPS`**   | <code>'here'</code>        |
+| **`MOOVIT`**      | <code>'moovit'</code>      |
+| **`LYFT`**        | <code>'lyft'</code>        |
+| **`MAPS_ME`**     | <code>'mapsme'</code>      |
+| **`CABIFY`**      | <code>'cabify'</code>      |
+| **`BAIDU`**       | <code>'baidu'</code>       |
+| **`GAODE`**       | <code>'gaode'</code>       |
+
+
+#### LaunchMode
+
+| Members            | Value                       |
+| ------------------ | --------------------------- |
+| **`MAPS`**         | <code>'maps'</code>         |
+| **`TURN_BY_TURN`** | <code>'turn_by_turn'</code> |
+| **`GEO`**          | <code>'geo'</code>          |
+
+</docgen-api>

package/android/build.gradle

@@ -0,0 +1,58 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.7.2'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace "app.capgo.plugin.launch_navigator"
+    compileSdk project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 35
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 23
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 35
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+    lintOptions {
+        abortOnError false
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

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