@dl2app/react-native 0.0.0-stage → 0.1.1

package/build/plugin/src/withDL2.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * Expo config plugin for @dl2app/react-native.
+ *
+ * It only edits the Expo config object (`ios.associatedDomains`, `android.intentFilters`,
+ * `scheme`); Expo's own prebuild steps turn those into entitlements and manifest entries.
+ * That keeps it a pure function: same input, same output, safe to run any number of times.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptions = normalizeOptions;
+exports.mergeAssociatedDomains = mergeAssociatedDomains;
+exports.mergeIntentFilters = mergeIntentFilters;
+exports.mergeSchemes = mergeSchemes;
+exports.applyDL2 = applyDL2;
+const NAME = "@dl2app/react-native";
+const ALLOWED = ["subdomain", "rootDomain", "domains", "iosDeveloperMode", "androidAutoVerify", "uriScheme"];
+const HOST = /^(\*\.)?([a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/;
+const LABEL = /^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/;
+const SCHEME = /^[a-z][a-z0-9+.-]*$/;
+function fail(message) {
+    throw new Error(`[${NAME}] ${message}`);
+}
+function checkHost(value, where) {
+    if (typeof value !== "string" || !value.trim())
+        fail(`${where} must be a host name such as "myapp.dl2.app".`);
+    const host = value.trim().toLowerCase();
+    if (/^[a-z][a-z0-9+.-]*:\/\//.test(host))
+        fail(`${where} is "${value}". Remove the "https://": use the host only, for example "myapp.dl2.app".`);
+    if (/[/?#]/.test(host))
+        fail(`${where} is "${value}". Remove the path: use the host only, for example "myapp.dl2.app".`);
+    if (/:\d+$/.test(host))
+        fail(`${where} is "${value}". Remove the port: app links only work on the default HTTPS port.`);
+    if (!HOST.test(host))
+        fail(`${where} is "${value}", which is not a valid host name. Example: "myapp.dl2.app".`);
+    return host;
+}
+function checkBool(value, name, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== "boolean")
+        fail(`"${name}" must be true or false, got ${JSON.stringify(value)}.`);
+    return value;
+}
+/** Validates the plugin options and returns the full host list. Throws with a fix in the message. */
+function normalizeOptions(raw) {
+    if (raw === undefined || raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        fail(`Missing options. Use ["${NAME}", { "subdomain": "myapp" }] or ["${NAME}", { "domains": ["myapp.dl2.app", "myapp-alt.dl2.app"] }].`);
+    }
+    const o = raw;
+    for (const key of Object.keys(o)) {
+        if (ALLOWED.indexOf(key) < 0)
+            fail(`Unknown option "${key}". Allowed options: ${ALLOWED.join(", ")}.`);
+    }
+    const domains = [];
+    const add = (h) => {
+        if (domains.indexOf(h) < 0)
+            domains.push(h);
+    };
+    if (o.rootDomain !== undefined && o.subdomain === undefined)
+        fail(`"rootDomain" only makes sense together with "subdomain".`);
+    if (o.subdomain !== undefined) {
+        if (typeof o.subdomain !== "string" || !LABEL.test(o.subdomain.trim().toLowerCase())) {
+            fail(`"subdomain" is ${JSON.stringify(o.subdomain)}. Use only the first part of your link host: "myapp" for myapp.dl2.app.`);
+        }
+        const sub = o.subdomain.trim().toLowerCase();
+        if (/-alt$/.test(sub))
+            fail(`"subdomain" is "${sub}". Leave out "-alt": the alternate host is added for you.`);
+        const root = o.rootDomain === undefined ? "dl2.app" : checkHost(o.rootDomain, `"rootDomain"`);
+        add(`${sub}.${root}`);
+        add(`${sub}-alt.${root}`);
+    }
+    if (o.domains !== undefined) {
+        if (!Array.isArray(o.domains))
+            fail(`"domains" must be a list of host names, got ${JSON.stringify(o.domains)}.`);
+        o.domains.forEach((d, i) => add(checkHost(d, `"domains[${i}]"`)));
+    }
+    if (!domains.length)
+        fail(`No link hosts. Pass "subdomain" (your DL2 project subdomain) or a non-empty "domains" list.`);
+    let uriScheme = null;
+    if (o.uriScheme !== undefined) {
+        if (typeof o.uriScheme !== "string" || !o.uriScheme)
+            fail(`"uriScheme" must be text such as "myapp".`);
+        const s = o.uriScheme.replace(/:\/\/$/, "");
+        if (!SCHEME.test(s))
+            fail(`"uriScheme" is "${o.uriScheme}". Use lowercase letters, digits, "+", "-" or ".", starting with a letter, and no "://".`);
+        if (s === "http" || s === "https")
+            fail(`"uriScheme" cannot be "${s}". Use a scheme of your own such as "myapp".`);
+        uriScheme = s;
+    }
+    return {
+        domains,
+        iosDeveloperMode: checkBool(o.iosDeveloperMode, "iosDeveloperMode", false),
+        androidAutoVerify: checkBool(o.androidAutoVerify, "androidAutoVerify", true),
+        uriScheme,
+    };
+}
+/** Adds `applinks:` entries, keeping every entry the app already has exactly as it is. */
+function mergeAssociatedDomains(existing, domains, developerMode) {
+    const out = Array.isArray(existing) ? existing.filter((e) => typeof e === "string") : [];
+    for (const d of domains) {
+        // A host the app already lists keeps its own mode: the option only applies to entries added here.
+        if (out.some((e) => e.split("?")[0].toLowerCase() === `applinks:${d}`))
+            continue;
+        out.push(`applinks:${d}${developerMode ? "?mode=developer" : ""}`);
+    }
+    return out;
+}
+function list(v) {
+    return v === undefined ? [] : Array.isArray(v) ? v : [v];
+}
+function isBrowsableView(f) {
+    return f.action === "VIEW" && list(f.category).indexOf("BROWSABLE") >= 0;
+}
+const RESTRICTIONS = ["port", "path", "pathPrefix", "pathPattern", "pathSuffix", "pathAdvancedPattern", "mimeType"];
+/** Android applies every path, port and type in a filter to all of its hosts, so one of them narrows the whole filter. */
+function isRestricted(f) {
+    return list(f.data).some((d) => RESTRICTIONS.some((k) => d[k] !== undefined && d[k] !== null && d[k] !== ""));
+}
+/** Adds one https intent filter for the hosts that are not covered yet, and one for the scheme. */
+function mergeIntentFilters(existing, domains, autoVerify, uriScheme) {
+    const out = Array.isArray(existing) ? existing.slice() : [];
+    const covered = new Set();
+    const schemes = new Set();
+    for (const f of out) {
+        if (!f || !isBrowsableView(f))
+            continue;
+        // A filter limited to some paths does not open every link of the host.
+        const open = !isRestricted(f);
+        for (const d of list(f.data)) {
+            if (open && d.scheme === "https" && typeof d.host === "string" && (!autoVerify || f.autoVerify === true))
+                covered.add(d.host.toLowerCase());
+            if (d.scheme && !d.host)
+                schemes.add(d.scheme);
+        }
+    }
+    const missing = domains.filter((d) => !covered.has(d));
+    if (missing.length) {
+        const filter = {
+            action: "VIEW",
+            data: missing.map((host) => ({ scheme: "https", host })),
+            category: ["BROWSABLE", "DEFAULT"],
+        };
+        if (autoVerify)
+            filter.autoVerify = true;
+        out.push(filter);
+    }
+    if (uriScheme && !schemes.has(uriScheme)) {
+        out.push({ action: "VIEW", data: [{ scheme: uriScheme }], category: ["BROWSABLE", "DEFAULT"] });
+    }
+    return out;
+}
+function mergeSchemes(existing, uriScheme) {
+    const current = list(existing).filter((s) => typeof s === "string");
+    if (!uriScheme || current.indexOf(uriScheme) >= 0)
+        return existing;
+    return current.length ? current.concat(uriScheme) : uriScheme;
+}
+/** The whole plugin as a pure function. Does not modify its input. */
+function applyDL2(config, rawOptions) {
+    const input = config;
+    const o = normalizeOptions(rawOptions);
+    const next = { ...input };
+    next.ios = { ...(input.ios || {}), associatedDomains: mergeAssociatedDomains(input.ios?.associatedDomains, o.domains, o.iosDeveloperMode) };
+    next.android = {
+        ...(input.android || {}),
+        intentFilters: mergeIntentFilters(input.android?.intentFilters, o.domains, o.androidAutoVerify, o.uriScheme),
+    };
+    const scheme = mergeSchemes(input.scheme, o.uriScheme);
+    if (scheme !== undefined)
+        next.scheme = scheme;
+    return next;
+}
+const withDL2 = (config, options) => applyDL2(config, options);
+exports.default = withDL2;

package/build/src/PasteButton.d.ts

@@ -0,0 +1,14 @@
+import { type ReactElement } from "react";
+export type DL2PasteButtonProps = {
+    /** Called with the pasted text after the user taps the button. */
+    onPaste: (text: string) => void;
+    /** Size the button here; the system draws its label and icon. */
+    style?: unknown;
+};
+/**
+ * The system paste button (UIPasteControl, iOS 16+). iOS hands over the clipboard only when the
+ * user taps it, and shows no "pasted from" banner. Renders nothing on Android and on older iOS.
+ *
+ *   <DL2PasteButton style={{ width: 160, height: 44 }} onPaste={(text) => DL2.matchClipboard(text)} />
+ */
+export declare function DL2PasteButton(props: DL2PasteButtonProps): ReactElement | null;

package/build/src/PasteButton.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DL2PasteButton = DL2PasteButton;
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const expo_modules_core_1 = require("expo-modules-core");
+let NativeView;
+function nativeView() {
+    if (NativeView === undefined) {
+        try {
+            NativeView = (0, expo_modules_core_1.requireNativeViewManager)("DL2");
+        }
+        catch {
+            NativeView = null;
+        }
+    }
+    return NativeView || null;
+}
+/**
+ * The system paste button (UIPasteControl, iOS 16+). iOS hands over the clipboard only when the
+ * user taps it, and shows no "pasted from" banner. Renders nothing on Android and on older iOS.
+ *
+ *   <DL2PasteButton style={{ width: 160, height: 44 }} onPaste={(text) => DL2.matchClipboard(text)} />
+ */
+function DL2PasteButton(props) {
+    if (react_native_1.Platform.OS !== "ios" || parseInt(String(react_native_1.Platform.Version), 10) < 16)
+        return null;
+    const View = nativeView();
+    if (!View)
+        return null;
+    return (0, react_1.createElement)(View, {
+        style: props.style || { width: 160, height: 44 },
+        onPaste: (e) => {
+            try {
+                const text = e && e.nativeEvent ? e.nativeEvent.text : undefined;
+                if (typeof text === "string" && text)
+                    props.onPaste(text);
+            }
+            catch {
+                /* never let a handler error reach the native event dispatcher */
+            }
+        },
+    });
+}

package/build/src/core.d.ts

@@ -0,0 +1,32 @@
+import type { DL2Config, DL2CreateLinkInput, DL2DebugInfo, DL2Deps, DL2LinkEvent, DL2TrackOptions } from "./types";
+export declare const SDK_VERSION = "0.1.1";
+type Listener = (event: DL2LinkEvent) => void;
+type Parsed = {
+    scheme: string;
+    host: string;
+    path: string;
+    params: Record<string, string>;
+};
+/** Small URL parser: React Native's built-in `URL` is incomplete on some versions. */
+export declare function parseUrl(url: unknown): Parsed | null;
+/** Finds a DL2 clipboard token (`dl2:{clickId}:{signature}`) in pasted text. */
+export declare function extractClipboardToken(text: unknown): string | null;
+export declare function createDL2(deps: DL2Deps): {
+    configure: (config: DL2Config) => void;
+    onLink: (listener: Listener) => () => void;
+    getInitialLink: () => Promise<DL2LinkEvent | null>;
+    resolve: (url: string) => Promise<DL2LinkEvent | null>;
+    track: (name: string, options?: DL2TrackOptions) => void;
+    /** Sends queued events now. Resolves when the attempt is over; never rejects. */
+    flush: () => Promise<void | undefined>;
+    createLink: (input: DL2CreateLinkInput) => Promise<{
+        url: string;
+    } | null>;
+    matchClipboard: (text: string) => Promise<DL2LinkEvent | null>;
+    reset: () => Promise<void>;
+    getInstallId: () => Promise<string | null>;
+    getDebugInfo: () => DL2DebugInfo;
+    version: string;
+};
+export type DL2Api = ReturnType<typeof createDL2>;
+export {};