@straitlink/capacitor 0.1.0 → 0.2.0

package/Package.swift

@@ -10,7 +10,7 @@ let package = Package(
     ],
     dependencies: [
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.0"),
-        .package(url: "https://github.com/strait-link/strait-sdk-swift.git", from: "0.9.3"),
+        .package(url: "https://github.com/strait-link/strait-sdk-swift.git", from: "0.9.4"),
     ],
     targets: [
         .target(

package/README.md

@@ -92,6 +92,19 @@ The app opens on the link's screen and the console prints
 `Strait link: direct app_link true /p/42` (your path). The open shows up in the dashboard's
 Analytics within a minute. On a fresh install the first launch prints a `deferred` event instead.
 
+### Check your setup
+
+In a debug build, after `start()`:
+
+```ts
+const report = await strait.doctor();
+for (const f of report.findings) console.log(f.severity, f.id, f.title, f.fix);
+```
+
+**You should see** `ok key.ok`, `ok app.listed` and, on Android, `ok cert.listed`. Anything marked
+`error` comes with the fix, for example `cert.missing`: "Add AB:CD:… in Dashboard → Apps & stores.
+Debug, release and Play App Signing keys each have their own fingerprint."
+
 ## Platform features
 
 | Feature | Status | Notes |
@@ -118,6 +131,7 @@ Analytics within a minute. On a fresh install the first launch prints a `deferre
 | `trackEvent(name, { value, currency, linkId, clickId })` | Conversion or revenue event, placed on the tap of the last attributed open (7 days). Resolves `true` when accepted. |
 | `pendingOpenReports()` / `flushOpenReports()` | Open reports saved while offline (sent again on start and resume). |
 | `deviceClass()` | `phone` or `tablet` (iPad / 600 dp and up), as sent with open reports. |
+| `doctor()` | Setup check for debug builds (key, endpoint, this app listed in your link domain's files, Android signing certificate). Resolves `{ ok, findings }`. |
 | `stop()` | Stops delivering events to this object. |
 
 `LinkEvent`: `id, kind (direct|deferred), route (app_link|custom_scheme|install_referrer|fingerprint|clipboard),
@@ -130,11 +144,11 @@ The plugin is a thin layer. All link logic (resolving short links, the once-per-
 check, open reports and their retry queue, app-state labels) runs in the native SDKs, which share
 golden test vectors with the Strait engine:
 
-- **Android:** `strait-sdk-android` **v0.8.1** from JitPack. The plugin adds JitPack to your Gradle
+- **Android:** `strait-sdk-android` **v0.8.3** from JitPack. The plugin adds JitPack to your Gradle
   repositories, limited to the `com.github.strait-link` group, so nothing else is ever fetched from
   it. It reads the Play Install Referrer (`com.android.installreferrer:installreferrer:2.2`), the launch
   intent and `onNewIntent`, and keeps state in SharedPreferences (`strait`).
-- **iOS:** `StraitSDK` **0.9.3+** through Swift Package Manager. Links come from Capacitor's
+- **iOS:** `StraitSDK` **0.9.4+** through Swift Package Manager. Links come from Capacitor's
   `capacitorOpenURL` / `capacitorOpenUniversalLink` notifications; state lives in `UserDefaults`.
 
 What gets recorded, the privacy details and the match methods are the same as the native SDKs:

package/android/build.gradle

@@ -1,6 +1,6 @@
 // @straitlink/capacitor, Android side: a thin Capacitor plugin over strait-sdk-android (JitPack).
 ext {
-    straitSdkVersion = 'v0.8.1'
+    straitSdkVersion = 'v0.8.3'
 }
 
 buildscript {

package/android/src/main/java/dev/strait/capacitor/StraitPlugin.java

@@ -4,6 +4,11 @@ import android.content.Context;
 import android.content.Intent;
 import android.content.SharedPreferences;
 import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.Signature;
+import android.os.Build;
+import android.util.Log;
 import android.util.DisplayMetrics;
 
 import com.android.installreferrer.api.InstallReferrerClient;
@@ -15,6 +20,7 @@ import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
 
+import java.security.MessageDigest;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Locale;
@@ -28,6 +34,8 @@ import java.util.concurrent.TimeUnit;
 import dev.strait.sdk.AppLifecycleState;
 import dev.strait.sdk.CoreKt;
 import dev.strait.sdk.DeviceFields;
+import dev.strait.sdk.DoctorFinding;
+import dev.strait.sdk.DoctorReport;
 import dev.strait.sdk.KeyValueStore;
 import dev.strait.sdk.LinkEvent;
 import dev.strait.sdk.LinkStart;
@@ -149,6 +157,58 @@ public class StraitPlugin extends Plugin {
         call.resolve(r);
     }
 
+    /** B23: setup check (debug builds). Sends this app's package and signing certificate(s). */
+    @PluginMethod
+    public void doctor(PluginCall call) {
+        StraitClient c = ready(call);
+        if (c == null) return;
+        Context ctx = getContext();
+        String pkg = ctx.getPackageName();
+        List<String> certs = signingCerts(ctx);
+        executor.execute(() -> {
+            DoctorReport r = c.doctor(pkg, certs);
+            JSArray list = new JSArray();
+            for (DoctorFinding f : r.getFindings()) {
+                JSObject o = new JSObject();
+                o.put("id", f.getId());
+                o.put("severity", f.getSeverity());
+                o.put("title", f.getTitle());
+                o.put("fix", f.getFix());
+                list.put(o);
+                Log.i("StraitDoctor", f.getSeverity() + " " + f.getId() + ": " + f.getTitle() + (f.getFix().isEmpty() ? "" : " → " + f.getFix()));
+            }
+            JSObject out = new JSObject();
+            out.put("ok", r.getOk());
+            out.put("findings", list);
+            call.resolve(out);
+        });
+    }
+
+    /** SHA-256 of this build's signing certificate(s), "AB:CD:…" (what assetlinks.json lists). */
+    @SuppressWarnings("deprecation")
+    private static List<String> signingCerts(Context ctx) {
+        List<String> out = new ArrayList<>();
+        try {
+            PackageManager pm = ctx.getPackageManager();
+            Signature[] sigs;
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+                PackageInfo pi = pm.getPackageInfo(ctx.getPackageName(), PackageManager.GET_SIGNING_CERTIFICATES);
+                sigs = pi.signingInfo == null ? new Signature[0]
+                    : pi.signingInfo.hasMultipleSigners() ? pi.signingInfo.getApkContentsSigners() : pi.signingInfo.getSigningCertificateHistory();
+            } else {
+                sigs = pm.getPackageInfo(ctx.getPackageName(), PackageManager.GET_SIGNATURES).signatures;
+            }
+            for (Signature sig : sigs) {
+                byte[] d = MessageDigest.getInstance("SHA-256").digest(sig.toByteArray());
+                StringBuilder b = new StringBuilder();
+                for (int i = 0; i < d.length; i++) b.append(i == 0 ? "" : ":").append(String.format("%02X", d[i]));
+                out.add(b.toString());
+            }
+        } catch (Exception ignored) {
+        }
+        return out;
+    }
+
     @Override
     protected void handleOnNewIntent(Intent intent) {
         super.handleOnNewIntent(intent);

package/dist/index.d.ts

@@ -6,4 +6,4 @@ export declare const StraitNative: StraitNativePlugin;
  * Android and iOS only; on the web every call resolves a safe default (use @straitlink/web there).
  */
 export declare function createStrait(config: CreateStraitConfig, native?: StraitNativePlugin): Strait;
-export type { CreateStraitConfig, DeviceClass, LinkEvent, LinkStart, Strait, StraitNativePlugin, TrackEventExtra, } from './strait.js';
+export type { CreateStraitConfig, DeviceClass, DoctorFinding, DoctorReport, LinkEvent, LinkStart, Strait, StraitNativePlugin, TrackEventExtra, } from './strait.js';

package/dist/strait.d.ts

@@ -34,6 +34,19 @@ export interface LinkStart {
     at: number;
 }
 export type DeviceClass = 'phone' | 'tablet';
+/** One setup check (contract B23, the same ids and wording in every Strait SDK). */
+export interface DoctorFinding {
+    id: string;
+    severity: 'ok' | 'warn' | 'error';
+    title: string;
+    /** What to do; empty for `ok`. */
+    fix: string;
+}
+export interface DoctorReport {
+    /** No `error` finding. */
+    ok: boolean;
+    findings: DoctorFinding[];
+}
 export interface CreateStraitConfig {
     /** Your workspace's publishable key (`st_pub_live_…`), Dashboard → Get started. Never the secret key. */
     publishableKey: string;
@@ -68,6 +81,7 @@ export interface StraitNativePlugin {
     deviceClass(): Promise<{
         deviceClass?: DeviceClass;
     }>;
+    doctor(): Promise<DoctorReport>;
     addListener(event: 'link', cb: (e: LinkEvent) => void): Promise<PluginListenerHandle>;
     addListener(event: 'linkStart', cb: (s: LinkStart) => void): Promise<PluginListenerHandle>;
 }
@@ -88,6 +102,12 @@ export interface Strait {
     flushOpenReports(): Promise<void>;
     /** What the app runs on, as sent with open reports (B14): iPad / sw600dp = tablet. */
     deviceClass(): Promise<DeviceClass | undefined>;
+    /**
+     * Setup check for debug builds (B23): key, endpoint, and whether your link domain's
+     * assetlinks.json / apple-app-site-association lists this app (Android: also this build's
+     * signing certificate). Call after start(). Never throws.
+     */
+    doctor(): Promise<DoctorReport>;
     /** Stop delivering events to this object. */
     stop(): void;
 }

package/dist/strait.js

@@ -59,6 +59,7 @@ export function createStrait(config, native) {
         pendingOpenReports: () => safe(async () => (await native.pendingOpenReports()).count ?? 0, 0),
         flushOpenReports: () => safe(() => native.flushOpenReports(), undefined),
         deviceClass: () => safe(async () => (await native.deviceClass()).deviceClass, undefined),
+        doctor: () => safe(() => native.doctor(), { ok: false, findings: [] }),
         stop() {
             linkCbs.clear();
             startCbs.clear();

package/ios/Sources/StraitPlugin/StraitPlugin.swift

@@ -17,6 +17,7 @@ public class StraitPlugin: CAPPlugin, CAPBridgedPlugin {
         CAPPluginMethod(name: "pendingOpenReports", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "flushOpenReports", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "deviceClass", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "doctor", returnType: CAPPluginReturnPromise),
     ]
 
     private var links: StraitLinks?
@@ -98,6 +99,18 @@ public class StraitPlugin: CAPPlugin, CAPBridgedPlugin {
         }
     }
 
+    /// B23: setup check (debug builds) for this app's bundle ID.
+    @objc func doctor(_ call: CAPPluginCall) {
+        guard let l = ready(call) else { return }
+        l.doctor(bundleId: Bundle.main.bundleIdentifier) { r in
+            for f in r.findings { print("[Strait doctor] \(f.severity) \(f.id): \(f.title)\(f.fix.isEmpty ? "" : " → \(f.fix)")") }
+            call.resolve([
+                "ok": r.ok,
+                "findings": r.findings.map { ["id": $0.id, "severity": $0.severity, "title": $0.title, "fix": $0.fix] },
+            ])
+        }
+    }
+
     private func ready(_ call: CAPPluginCall) -> StraitLinks? {
         guard let l = links else {
             call.reject("Strait: call start() first")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@straitlink/capacitor",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Deep linking for Capacitor and Ionic apps: direct links (App Links, Universal Links, custom schemes), deferred links that survive the install and link-open analytics. Wraps the Strait Android and iOS SDKs.",
   "keywords": [
     "capacitor",