@meetreeve/capacitor-bridge 0.1.0

package/dist/bugreport/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Bug-report widget.
+ *
+ * TestFlight beta users hit "Report a bug" → small modal → text + optional
+ * screenshot → POST to a consumer-configured endpoint (typically a thin
+ * Slack-relay route on the consumer's backend). Sentry user feedback works
+ * too but the social UX of a Slack channel + screenshot is what beta cohorts
+ * actually respond to.
+ *
+ * This module owns the submission contract + a tiny snapshot helper. The
+ * React widget itself ships in src/react/BugReportButton.tsx (next step) —
+ * consumer apps that don't use React can call submitBugReport() directly.
+ */
+interface BugReportPayload {
+    message: string;
+    /** Optional screenshot — data URL or remote URL — uploaded as part of report. */
+    screenshot?: string;
+    /** Consumer-supplied user identifier (subscriber_id, email — whatever's stable). */
+    userIdentifier?: string;
+    /** Free-form metadata; merged with platform info before send. */
+    extra?: Record<string, unknown>;
+}
+interface BugReportEnvironment {
+    platform: string;
+    userAgent: string;
+    appVersion?: string;
+    buildNumber?: string;
+    currentUrl: string;
+    timestamp: string;
+}
+interface BugReportSubmission extends BugReportPayload {
+    environment: BugReportEnvironment;
+}
+interface BugReportConfig {
+    endpoint: string;
+    /** Headers to attach (auth token, host-app key, etc.). */
+    headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    /** Consumer-supplied version metadata. */
+    appVersion?: string;
+    buildNumber?: string;
+    /**
+     * fetch credentials mode. Defaults to `"omit"` because the Capacitor
+     * WebView origin (`capacitor://localhost`) differs from the consumer's API
+     * origin, so cookie-based auth wouldn't flow anyway, and `omit` avoids
+     * accidentally turning the bug-report endpoint into a CSRF target if the
+     * consumer enables permissive CORS. Set to `"include"` only when you
+     * understand the consequences for the consumer's endpoint.
+     */
+    credentials?: "omit" | "same-origin" | "include";
+}
+declare function configureBugReport(c: BugReportConfig): void;
+/** Internal — for tests only. */
+declare function __resetBugReportConfigForTests(): void;
+/** @deprecated use __resetBugReportConfigForTests; prod calls now warn. */
+declare function resetBugReportConfig(): void;
+declare function getBugReportEnvironment(): BugReportEnvironment;
+/**
+ * Submit a bug report to the configured endpoint. Throws if not configured.
+ *
+ * The post body always includes a top-level `environment` object — consumer
+ * backends can route on `environment.platform === "ios"` to tag with a
+ * Slack emoji, etc.
+ */
+declare function submitBugReport(payload: BugReportPayload): Promise<void>;
+/**
+ * Capture the current screen as a data URL using the Capacitor Screenshot
+ * plugin (if present) or a DOM-canvas fallback. Returns null if no capture
+ * method is available — the bug-report modal then submits without an image.
+ *
+ * Note: many WebView screenshot plugins can't capture native chrome (push
+ * banners, system alerts). For TestFlight QA that's fine — the bug message
+ * almost always describes the chrome anyway.
+ */
+declare function captureScreenshot(): Promise<string | null>;
+
+export { type BugReportEnvironment, type BugReportPayload, type BugReportSubmission, __resetBugReportConfigForTests, captureScreenshot, configureBugReport, getBugReportEnvironment, resetBugReportConfig, submitBugReport };

package/dist/bugreport/index.js

@@ -0,0 +1,111 @@
+// src/core/platform.ts
+function getCapacitor() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  if (!cap || typeof cap.isNativePlatform !== "function") return null;
+  return cap;
+}
+function getPlatform() {
+  const cap = getCapacitor();
+  if (!cap) return "web";
+  const p = cap.getPlatform();
+  return p === "ios" ? "ios" : p === "android" ? "android" : "web";
+}
+
+// src/bugreport/index.ts
+var GLOBAL_KEY = /* @__PURE__ */ Symbol.for("@meetreeve/capacitor-bridge/bugreport@1");
+function getGlobalState() {
+  const g = globalThis;
+  if (!g[GLOBAL_KEY]) g[GLOBAL_KEY] = { config: null };
+  return g[GLOBAL_KEY];
+}
+function configureBugReport(c) {
+  const state = getGlobalState();
+  if (state.config && state.config.endpoint !== c.endpoint) {
+    throw new Error(
+      "[@meetreeve/capacitor-bridge/bugreport] configureBugReport has already been called with a different endpoint. Re-configuration is refused so a later-loaded script cannot redirect bug-report submissions. Call __resetBugReportConfigForTests() in tests."
+    );
+  }
+  state.config = Object.freeze({ ...c });
+}
+function __resetBugReportConfigForTests() {
+  getGlobalState().config = null;
+}
+function resetBugReportConfig() {
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(
+      "[@meetreeve/capacitor-bridge/bugreport] resetBugReportConfig is deprecated; use __resetBugReportConfigForTests."
+    );
+  }
+  __resetBugReportConfigForTests();
+}
+function getBugReportEnvironment() {
+  const config = getGlobalState().config;
+  if (typeof window === "undefined") {
+    return {
+      platform: getPlatform(),
+      userAgent: "",
+      currentUrl: "",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
+  return {
+    platform: getPlatform(),
+    userAgent: window.navigator?.userAgent ?? "",
+    appVersion: config?.appVersion,
+    buildNumber: config?.buildNumber,
+    currentUrl: window.location?.href ?? "",
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+async function submitBugReport(payload) {
+  const config = getGlobalState().config;
+  if (!config) {
+    throw new Error(
+      "[@meetreeve/capacitor-bridge/bugreport] submitBugReport called without configureBugReport({endpoint})."
+    );
+  }
+  const submission = {
+    ...payload,
+    environment: getBugReportEnvironment()
+  };
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (config.headers) {
+    const extraHeaders = await config.headers();
+    Object.assign(headers, extraHeaders);
+  }
+  const response = await fetch(config.endpoint, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(submission),
+    credentials: config.credentials ?? "omit"
+  });
+  if (!response.ok) {
+    throw new Error(
+      `[@meetreeve/capacitor-bridge/bugreport] bug-report submission failed: ${response.status} ${response.statusText}`
+    );
+  }
+}
+async function captureScreenshot() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  const plugin = cap?.Plugins?.Screenshot;
+  if (plugin) {
+    try {
+      const { base64 } = await plugin.take();
+      return `data:image/png;base64,${base64}`;
+    } catch {
+    }
+  }
+  return null;
+}
+export {
+  __resetBugReportConfigForTests,
+  captureScreenshot,
+  configureBugReport,
+  getBugReportEnvironment,
+  resetBugReportConfig,
+  submitBugReport
+};

package/dist/core/index.cjs

@@ -0,0 +1,160 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/index.ts
+var core_exports = {};
+__export(core_exports, {
+  __resetSplashStateForTests: () => __resetSplashStateForTests,
+  dismissSplash: () => dismissSplash,
+  getPlatform: () => getPlatform,
+  getSafeAreaInsets: () => getSafeAreaInsets,
+  hasSafeAreaInsets: () => hasSafeAreaInsets,
+  installSafeAreaVars: () => installSafeAreaVars,
+  isAndroid: () => isAndroid,
+  isIOS: () => isIOS,
+  isNativePlatform: () => isNativePlatform,
+  resetSplashState: () => resetSplashState
+});
+module.exports = __toCommonJS(core_exports);
+
+// src/core/platform.ts
+function getCapacitor() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  if (!cap || typeof cap.isNativePlatform !== "function") return null;
+  return cap;
+}
+function getPlatform() {
+  const cap = getCapacitor();
+  if (!cap) return "web";
+  const p = cap.getPlatform();
+  return p === "ios" ? "ios" : p === "android" ? "android" : "web";
+}
+function isNativePlatform() {
+  return getPlatform() !== "web";
+}
+function isIOS() {
+  return getPlatform() === "ios";
+}
+function isAndroid() {
+  return getPlatform() === "android";
+}
+
+// src/core/safe-area.ts
+var ZERO = { top: 0, right: 0, bottom: 0, left: 0 };
+function getSafeAreaInsets() {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return ZERO;
+  }
+  const root = document.documentElement;
+  const styles = window.getComputedStyle(root);
+  const read = (side) => {
+    const v = styles.getPropertyValue(`--safe-area-inset-${side}`).trim();
+    const n = parseFloat(v);
+    return Number.isFinite(n) ? n : 0;
+  };
+  return {
+    top: read("top"),
+    right: read("right"),
+    bottom: read("bottom"),
+    left: read("left")
+  };
+}
+function installSafeAreaVars() {
+  if (typeof document === "undefined") return;
+  const TAG = "reeve-capacitor-bridge-safe-area";
+  if (document.querySelector(`style[data-${TAG}]`)) return;
+  const style = document.createElement("style");
+  style.setAttribute(`data-${TAG}`, "1");
+  style.textContent = `
+    :root {
+      --safe-area-inset-top: env(safe-area-inset-top, 0px);
+      --safe-area-inset-right: env(safe-area-inset-right, 0px);
+      --safe-area-inset-bottom: env(safe-area-inset-bottom, 0px);
+      --safe-area-inset-left: env(safe-area-inset-left, 0px);
+    }
+  `;
+  document.head.appendChild(style);
+}
+function hasSafeAreaInsets() {
+  if (!isNativePlatform()) return false;
+  const insets = getSafeAreaInsets();
+  return insets.top > 0 || insets.bottom > 0;
+}
+
+// src/core/splash.ts
+function getSplashPlugin() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  return cap?.Plugins?.SplashScreen ?? null;
+}
+var GLOBAL_KEY = /* @__PURE__ */ Symbol.for("@meetreeve/capacitor-bridge/splash@1");
+function getGlobalState() {
+  const g = globalThis;
+  if (!g[GLOBAL_KEY]) g[GLOBAL_KEY] = { done: null, pending: null };
+  return g[GLOBAL_KEY];
+}
+async function dismissSplash(fadeOutDuration = 250) {
+  if (!isNativePlatform()) return;
+  const state = getGlobalState();
+  if (state.done) return state.done;
+  if (state.pending) return state.pending;
+  const plugin = getSplashPlugin();
+  if (!plugin) return;
+  const attempt = (async () => {
+    try {
+      await plugin.hide({ fadeOutDuration });
+      state.done = Promise.resolve();
+    } catch (err) {
+      state.pending = null;
+      throw err;
+    } finally {
+      if (state.done) state.pending = null;
+    }
+  })();
+  state.pending = attempt;
+  return attempt.catch(() => {
+  });
+}
+function __resetSplashStateForTests() {
+  const state = getGlobalState();
+  state.done = null;
+  state.pending = null;
+}
+function resetSplashState() {
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(
+      "[@meetreeve/capacitor-bridge/splash] resetSplashState is deprecated; use __resetSplashStateForTests."
+    );
+  }
+  __resetSplashStateForTests();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  __resetSplashStateForTests,
+  dismissSplash,
+  getPlatform,
+  getSafeAreaInsets,
+  hasSafeAreaInsets,
+  installSafeAreaVars,
+  isAndroid,
+  isIOS,
+  isNativePlatform,
+  resetSplashState
+});

package/dist/core/index.d.cts

@@ -0,0 +1,29 @@
+export { N as NativePlatform, P as Platform, S as SafeAreaInsets, g as getPlatform, a as getSafeAreaInsets, h as hasSafeAreaInsets, i as installSafeAreaVars, b as isAndroid, c as isIOS, d as isNativePlatform } from '../safe-area-B67yGQOn.cjs';
+
+/**
+ * Splash bridge. Capacitor's SplashScreen plugin holds the native launch
+ * screen visible until JS explicitly hides it. Without this bridge, every
+ * consumer app would have to figure out the right moment to call hide().
+ *
+ * The pattern we standardize: hide on first paint of authenticated content
+ * (or first paint of the public landing if no auth). Consumer apps call
+ * dismissSplash() once their root component has mounted.
+ */
+/**
+ * Dismiss the native splash screen. No-op on web or if already successfully
+ * dismissed once. Concurrent callers coalesce onto a single in-flight
+ * dismiss promise so the plugin only sees one `hide()` call per attempt,
+ * and a plugin error releases the latch so a later attempt can retry.
+ *
+ * Fade-out defaults to 250ms for a perceptibly smooth handoff to JS-rendered
+ * content (vs the plugin's default which can feel abrupt).
+ */
+declare function dismissSplash(fadeOutDuration?: number): Promise<void>;
+/**
+ * Internal — clears the dismissed latch. For tests only.
+ */
+declare function __resetSplashStateForTests(): void;
+/** @deprecated use __resetSplashStateForTests; prod calls now warn. */
+declare function resetSplashState(): void;
+
+export { __resetSplashStateForTests, dismissSplash, resetSplashState };

package/dist/core/index.d.ts

@@ -0,0 +1,29 @@
+export { N as NativePlatform, P as Platform, S as SafeAreaInsets, g as getPlatform, a as getSafeAreaInsets, h as hasSafeAreaInsets, i as installSafeAreaVars, b as isAndroid, c as isIOS, d as isNativePlatform } from '../safe-area-B67yGQOn.js';
+
+/**
+ * Splash bridge. Capacitor's SplashScreen plugin holds the native launch
+ * screen visible until JS explicitly hides it. Without this bridge, every
+ * consumer app would have to figure out the right moment to call hide().
+ *
+ * The pattern we standardize: hide on first paint of authenticated content
+ * (or first paint of the public landing if no auth). Consumer apps call
+ * dismissSplash() once their root component has mounted.
+ */
+/**
+ * Dismiss the native splash screen. No-op on web or if already successfully
+ * dismissed once. Concurrent callers coalesce onto a single in-flight
+ * dismiss promise so the plugin only sees one `hide()` call per attempt,
+ * and a plugin error releases the latch so a later attempt can retry.
+ *
+ * Fade-out defaults to 250ms for a perceptibly smooth handoff to JS-rendered
+ * content (vs the plugin's default which can feel abrupt).
+ */
+declare function dismissSplash(fadeOutDuration?: number): Promise<void>;
+/**
+ * Internal — clears the dismissed latch. For tests only.
+ */
+declare function __resetSplashStateForTests(): void;
+/** @deprecated use __resetSplashStateForTests; prod calls now warn. */
+declare function resetSplashState(): void;
+
+export { __resetSplashStateForTests, dismissSplash, resetSplashState };

package/dist/core/index.js

@@ -0,0 +1,124 @@
+// src/core/platform.ts
+function getCapacitor() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  if (!cap || typeof cap.isNativePlatform !== "function") return null;
+  return cap;
+}
+function getPlatform() {
+  const cap = getCapacitor();
+  if (!cap) return "web";
+  const p = cap.getPlatform();
+  return p === "ios" ? "ios" : p === "android" ? "android" : "web";
+}
+function isNativePlatform() {
+  return getPlatform() !== "web";
+}
+function isIOS() {
+  return getPlatform() === "ios";
+}
+function isAndroid() {
+  return getPlatform() === "android";
+}
+
+// src/core/safe-area.ts
+var ZERO = { top: 0, right: 0, bottom: 0, left: 0 };
+function getSafeAreaInsets() {
+  if (typeof window === "undefined" || typeof document === "undefined") {
+    return ZERO;
+  }
+  const root = document.documentElement;
+  const styles = window.getComputedStyle(root);
+  const read = (side) => {
+    const v = styles.getPropertyValue(`--safe-area-inset-${side}`).trim();
+    const n = parseFloat(v);
+    return Number.isFinite(n) ? n : 0;
+  };
+  return {
+    top: read("top"),
+    right: read("right"),
+    bottom: read("bottom"),
+    left: read("left")
+  };
+}
+function installSafeAreaVars() {
+  if (typeof document === "undefined") return;
+  const TAG = "reeve-capacitor-bridge-safe-area";
+  if (document.querySelector(`style[data-${TAG}]`)) return;
+  const style = document.createElement("style");
+  style.setAttribute(`data-${TAG}`, "1");
+  style.textContent = `
+    :root {
+      --safe-area-inset-top: env(safe-area-inset-top, 0px);
+      --safe-area-inset-right: env(safe-area-inset-right, 0px);
+      --safe-area-inset-bottom: env(safe-area-inset-bottom, 0px);
+      --safe-area-inset-left: env(safe-area-inset-left, 0px);
+    }
+  `;
+  document.head.appendChild(style);
+}
+function hasSafeAreaInsets() {
+  if (!isNativePlatform()) return false;
+  const insets = getSafeAreaInsets();
+  return insets.top > 0 || insets.bottom > 0;
+}
+
+// src/core/splash.ts
+function getSplashPlugin() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  return cap?.Plugins?.SplashScreen ?? null;
+}
+var GLOBAL_KEY = /* @__PURE__ */ Symbol.for("@meetreeve/capacitor-bridge/splash@1");
+function getGlobalState() {
+  const g = globalThis;
+  if (!g[GLOBAL_KEY]) g[GLOBAL_KEY] = { done: null, pending: null };
+  return g[GLOBAL_KEY];
+}
+async function dismissSplash(fadeOutDuration = 250) {
+  if (!isNativePlatform()) return;
+  const state = getGlobalState();
+  if (state.done) return state.done;
+  if (state.pending) return state.pending;
+  const plugin = getSplashPlugin();
+  if (!plugin) return;
+  const attempt = (async () => {
+    try {
+      await plugin.hide({ fadeOutDuration });
+      state.done = Promise.resolve();
+    } catch (err) {
+      state.pending = null;
+      throw err;
+    } finally {
+      if (state.done) state.pending = null;
+    }
+  })();
+  state.pending = attempt;
+  return attempt.catch(() => {
+  });
+}
+function __resetSplashStateForTests() {
+  const state = getGlobalState();
+  state.done = null;
+  state.pending = null;
+}
+function resetSplashState() {
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(
+      "[@meetreeve/capacitor-bridge/splash] resetSplashState is deprecated; use __resetSplashStateForTests."
+    );
+  }
+  __resetSplashStateForTests();
+}
+export {
+  __resetSplashStateForTests,
+  dismissSplash,
+  getPlatform,
+  getSafeAreaInsets,
+  hasSafeAreaInsets,
+  installSafeAreaVars,
+  isAndroid,
+  isIOS,
+  isNativePlatform,
+  resetSplashState
+};

package/dist/deeplink/index.cjs

@@ -0,0 +1,166 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/deeplink/index.ts
+var deeplink_exports = {};
+__export(deeplink_exports, {
+  __resetDeepLinkHandlersForTests: () => __resetDeepLinkHandlersForTests,
+  dispatchDeepLink: () => dispatchDeepLink,
+  parseDeepLink: () => parseDeepLink,
+  registerDeepLinkHandler: () => registerDeepLinkHandler,
+  resetDeepLinkHandlers: () => resetDeepLinkHandlers,
+  startDeepLinkListener: () => startDeepLinkListener,
+  stopDeepLinkListener: () => stopDeepLinkListener
+});
+module.exports = __toCommonJS(deeplink_exports);
+
+// src/core/platform.ts
+function getCapacitor() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  if (!cap || typeof cap.isNativePlatform !== "function") return null;
+  return cap;
+}
+function getPlatform() {
+  const cap = getCapacitor();
+  if (!cap) return "web";
+  const p = cap.getPlatform();
+  return p === "ios" ? "ios" : p === "android" ? "android" : "web";
+}
+function isNativePlatform() {
+  return getPlatform() !== "web";
+}
+
+// src/deeplink/index.ts
+function getAppPlugin() {
+  if (typeof window === "undefined") return null;
+  const cap = window.Capacitor;
+  return cap?.Plugins?.App ?? null;
+}
+var WEB_SCHEMES = /* @__PURE__ */ new Set(["http", "https", "ws", "wss", "file"]);
+function normalizePath(raw) {
+  if (!raw || raw === "/") return "/";
+  const collapsed = raw.replace(/\/+/g, "/");
+  if (collapsed === "/") return "/";
+  return collapsed.endsWith("/") ? collapsed.slice(0, -1) : collapsed;
+}
+function parseDeepLink(url) {
+  const parsed = new URL(url);
+  const scheme = parsed.protocol.replace(/:$/, "");
+  const query = {};
+  parsed.searchParams.forEach((value, key) => {
+    query[key] = value;
+  });
+  const isWeb = WEB_SCHEMES.has(scheme);
+  const rawHost = parsed.host;
+  const rawPath = parsed.pathname || "";
+  const host = isWeb ? rawHost : "";
+  const path = isWeb ? normalizePath(rawPath || "/") : normalizePath(`/${rawHost}${rawPath}`);
+  return {
+    url,
+    scheme,
+    host,
+    path,
+    query,
+    hash: parsed.hash.replace(/^#/, "")
+  };
+}
+var GLOBAL_KEY = /* @__PURE__ */ Symbol.for("@meetreeve/capacitor-bridge/deeplink@1");
+function getGlobalState() {
+  const g = globalThis;
+  if (!g[GLOBAL_KEY]) {
+    g[GLOBAL_KEY] = { handlers: [], listenerPromise: null, allowedSchemes: null };
+  }
+  return g[GLOBAL_KEY];
+}
+function registerDeepLinkHandler(handler) {
+  const state = getGlobalState();
+  state.handlers.push(handler);
+  return () => {
+    const idx = state.handlers.indexOf(handler);
+    if (idx >= 0) state.handlers.splice(idx, 1);
+  };
+}
+function __resetDeepLinkHandlersForTests() {
+  const state = getGlobalState();
+  state.handlers.length = 0;
+  state.listenerPromise = null;
+  state.allowedSchemes = null;
+}
+function resetDeepLinkHandlers() {
+  if (typeof console !== "undefined" && typeof console.warn === "function") {
+    console.warn(
+      "[@meetreeve/capacitor-bridge/deeplink] resetDeepLinkHandlers is deprecated; use __resetDeepLinkHandlersForTests."
+    );
+  }
+  __resetDeepLinkHandlersForTests();
+}
+async function dispatchDeepLink(link) {
+  const state = getGlobalState();
+  for (const h of state.handlers) {
+    try {
+      const result = await h(link);
+      if (result === true) return true;
+    } catch {
+    }
+  }
+  return false;
+}
+function startDeepLinkListener(opts = {}) {
+  if (!isNativePlatform()) return null;
+  const state = getGlobalState();
+  if (opts.allowedSchemes !== void 0) {
+    state.allowedSchemes = new Set(opts.allowedSchemes);
+  }
+  if (state.listenerPromise) return state.listenerPromise;
+  const plugin = getAppPlugin();
+  if (!plugin) return null;
+  state.listenerPromise = plugin.addListener("appUrlOpen", (event) => {
+    let link;
+    try {
+      link = parseDeepLink(event.url);
+    } catch {
+      return;
+    }
+    if (state.allowedSchemes && !state.allowedSchemes.has(link.scheme)) {
+      return;
+    }
+    void dispatchDeepLink(link).then((handled) => {
+      if (!handled && opts.onUnhandled) opts.onUnhandled(link);
+    });
+  });
+  return state.listenerPromise;
+}
+async function stopDeepLinkListener() {
+  const state = getGlobalState();
+  if (!state.listenerPromise) return;
+  const listener = await state.listenerPromise;
+  state.listenerPromise = null;
+  await listener.remove();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  __resetDeepLinkHandlersForTests,
+  dispatchDeepLink,
+  parseDeepLink,
+  registerDeepLinkHandler,
+  resetDeepLinkHandlers,
+  startDeepLinkListener,
+  stopDeepLinkListener
+});